Tektronix DSA70000/B Series, DPO70000/B Series, DPO7000 Series Programmer's Manual

Download

DPO7000, DPO70000/B and DSA70000/B Series

ZZZ

Digital Oscilloscopes

Programmer Manual

*P077001006*

077-0010-06

DPO7000, DPO70000/B and DSA70000/B Series

ZZZ

Digital Oscilloscopes

Programmer Manual

www.tektronix.com

077-0010-06

Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions.

Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in all previously published material. Speciﬁcations and price change privileges reserved.

TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.

FastFrame, OpenChoice, iView, Pinpoint, RT-Eye, MyScope, TekLink, TekVPI, and MultiView Zoom are trademarks of Tektronix, Inc.

Contacting

Tektronix, Inc. 14200 SW Karl Braun Drive P.O . B o x 5 Beaverton, OR 97077 USA

For product information, sales, s ervice, and technical support:

In North America, call 1-800-833-9200. Worl d w

Tektronix

ide, visit www.tektronix.com to ﬁnd contacts in your area.

Table of Contents

Preface .............................................................................................................. iii

Getting Started . . ... ... ... . ... ... . .. . ... ... . .. . ... ... . ... ... ... . ... ... . ... ... . .. . ... ... . .. . ... ... . ... ... ... . ... ... . 1-1

Setting Up Remote Communications. ... . ... ... ... . ... ... . ... ... . ... ... .... ... ... . ... ... . ... ... . ... ... . .. . 1-1

Command Syntax.............................. ................................ ................................ ... 2-1

Backus-Naur Form Notation ............................................................................... 2-1

Command and Query Structure ............................................................................ 2-1

Clearing the Instrument ..................................................................................... 2-3

Command Entry.............................................................................................. 2-4

Constructed Mnemonics .................................................................................... 2-6

Argument Types........................... ................................ .................................. . 2-7

Command Groups .............................................................................................. 2-11

Acquisition Command Group .. . ... ... . ... ... ... . ... ... . .. . ... ... . ... ... ... . ... ... . ... ... ... . ... ... . .. . .. 2-11

Alias Command Group..................... ................................ ............................... 2-12

Calibration Command Group............................................................................. 2-13

Cursor Command Group ......................... .................................. ....................... 2-13

Diagnostics Command Group ............................................................................ 2-16

Display Control Command Group ............ ................................ ........................... 2-17

E-mail Command Group ......................... ................................ ......................... 2-19

File System Command Group....................... ................................ ..................... 2-21

Hard Copy Command Group ................ ................................ ............................. 2-22

Histogram Command Group ............................................................................. 2-23

Horizontal Command Group ........ ................................ .................................. ... 2-24

Limit Test Command Group............... ................................ ............................... 2-27

Low Speed Serial Trigger Command Group............................... ............................. 2-28

Mask Command Group ................ ................................ .................................. . 2-31

Math Command Group........... .................................. ................................ ....... 2-37

Measurement Command Group........................... ................................ ............... 2-39

Miscellaneous Command Group ......................................................................... 2-43

Save and Recall Command Group ....................................................................... 2-44

Search and Mark Command Group ......................... ................................ ............. 2-45

Status and Error Command Group...... ................................ ................................. 2-54

TekLink Command Group ................................................................................ 2-55

Trigger Command Group ............ ................................ ................................ ..... 2-56

Vertical Command Group...................... ................................ ........................... 2-63

Waveform Transfer Command Group................................................................... 2-67

Zoom Command Group................................................................................... 2-72

Commands Listed in Alphabetical Order ..................... ................................ ............... 2-75

Status and Events................................................................................................. 3-1

Registers ............. ................................ .................................. ....................... 3-1

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual i

Table of Contents

........................ ................................ ................................ ......................... 3-3

Queues ........................................................................................................ 3-4

Event Handling Sequence................................................................................... 3-5

Synchronization Methods............................ ................................ ....................... 3-6

Appendix A: Character Set ..................................................................................... A-1

Appendix B: Reserved Words .................................................................................. B-1

Appendix C:

Default Setup................................ ................................ ................................ C-1

Appendix D: GPIB Interface Speciﬁcations........ ................................ .......................... D-1

Interface Messages ......................................................................................... D-1

GPIB Functions ............................................................................................. D-2

Glossary

Index

Factory Default Setup Values............................. .................................. .... C-1

ii DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Preface

This programmer manual provides you with the information required to u se GPIB commands for remotely controlling your instrument.

Documentat

ion

Quick Start User Manual. The user manual has information about

installing theories about using the instrument that are not covered in the online help.

Online Help. This is an online help system that is integrated with the U ser Interface in-depth operation and user interface help.

Getting Started with OpenChoice ™ Solutions Manual. A book that explores s of several available analysis tools.

Speciﬁcations and Performance Veriﬁcation. Instrument speciﬁcations and a perf PDF ﬁle on the Product Software CD-ROM.

TekVIS A Programmer Manual. This manual is available as a printable PDF ﬁle on TekVISA, the Tektronix implementation of the VISA Application Programming Interface (API). TekVISA is industry-compliant software for writ Development Environments (ADEs).

Optional Applications Software for Tektronix Windows-Based Instru

application-speciﬁc programs that you can install and run ﬁve times per application. To purchase an application, contact your local Tektronix repres

Other Included Documentation. Installation booklets are included in the Product S oftware and Operating System Restore Software packages.

Servi instrument to the module level. This manual is available as a printable PDF ﬁle on the Product Software CD-ROM.

and operating the instrument. It also provides concepts and

application that ships with this product. The online help provides

ome options for getting data from your instrument into any one

ormance veriﬁcation procedure. This is available as a printable

the Product Software CD-ROM. The manual describes

ing interoperable instrument drivers in a variety of Application

ments (CD-ROM). This CD-ROM contains trial versions of

entative.

ce Manual. The service manual includes procedures to service the

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual iii

Preface

The programmer

Getting Started. This topic introduces you to the programming information and provides basic information about setting up your instrument for remote control.

Command Groups. This topic contains all the commands listed in functional groups. Each group consists of an overview of the commands in that group and a table that command in the listing to display a detailed description of the command.

Command Sy that you use to communicate with the instrument and other general information about commands, such as how commands and queries are constructed, how to enter commands, constructed mnemonics, and argument types.

Status and Events. This topic discusses the status and event reporting system for the GPIB interfaces. This system informs you of certain signiﬁcant events that occur within the instrument. Topics that are discussed include registers, queues, event handling sequences, synchronization methods, and messages

he instrument may return, including error messages.

that t

Miscellaneous. This topic contains miscellaneous information, such as a

f reserved words, a table of the factory initialization (default) settings,

list o and interface speciﬁcations that may be helpful when using commands to remotely control the instrument.

guide is divided into the following major topics:

lists all the commands and queries for that group. You can click a

ntax. This topic provides an overview of the command syntax

iv DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Getting Started

This programmer guide provides you with the information required to use GPIB commands for remotely controlling your instrument. With this information, you can write com panel controls, taking measurements, performing statistical calculations, and exporting data for use in other programs, such as spreadsheets.

In addition to the traditional GPIB electronic interface (referred to as the physical GPIB interface), your instrument is provided with a Tek V IS A GPIB-compatible interface (referred to as the virtual GPIB interface). This is a software Application Programming Interface (API) which enables you to communicate with the instrument in a variety of ways, including via the Internet. With the following two excepti

ons, these interfaces are completely independent:

HEADER. Command headers enabled or disabled on one interface are corresp command descriptions for more detailed information.

puter programs that will perform functions such as setting the front

ondingly enabled or disabled on the other interface. Refer to the

VERBOS enabled or disabled on the other interface. Refer to the command description for more detailed information.

Most examples in this document require that both

rtoDocumentation for information on related manuals and documents.

Refe

E. Verbosity enabled or disabled on one interface is correspondingly

Setting Up Remote Communications

ore setting up the instrument for remote communications using the electronic

Bef (physical) GPIB interface, you should familiarize yourself with the following GPIB requirements:

A unique device address must be assigned to each device on the bus. No two devices can share the same device address.

No more than 15 devices can be connected to any one line.

One device should be connected for every 6 feet (2 meters) of cable used.

No more than 65 feet (20 meters) of cable should be used to connect devices to a bus.

At least two-thirds of the d evices on the network should be powered on while using the network.

HEADER and VERBOSE are ON.

Connect the devices on the network in a star or linear conﬁguration. Do not use loop or parallel conﬁgurations.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 1-1

Getting Started

Connecting to the

Instrument

You r i nst rum en connector has a D-type shell and conforms to IEEE Std 488.1¾1987. Attach an IEEE Std 488.1¾1987 GPIB cable to this connector and to your controller as shown in the following ﬁgure.

If necessary, the GPIB connectors can be stacked as shown in the following ﬁgure.

t has a 24-pin GPIB connector on its rear (side) panel. This

Setting the GPIB Address

1-2 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

To function correctly, your instrument must have a unique device address. The default settings for the GPIB conﬁguration are:

GPIB Address 1

GPIB ModeGPIB Talk/Listen

To change either of the GPIB settings, do the following:

1. Select GPIB Conﬁguration from the Utilities menu.

Getting Started

2. Click the Conﬁguration Talk/Listen button.

3. Change the GPIB Address to a unique address.

4. Click the Close button.

The instrument is now set up for bidirectional communication with your controller.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 1-3

Getting Started

1-4 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Syntax

You can control the operations and functions of the instrument through the GPIB interface using commands and queries. The following related topics listed describe the conventions that the instrument uses to process them. See the Command Groups topic in the table of contents for a listing of the commands by command group, or use the index to locate a speciﬁccommand.

Backus-Naur Form Notation

This documentation describes the commands and queries using Backus-Naur Form (BNF) notation. Refer to the following table for the symbols that are used.

Table 2-1: Symbols for Backus-Naur Form

Symbol Meaning

::=

| Exclusive OR

{ } Group; one element is required

[] .. .

( ) Comment

syntax of these commands and queries. The topics also describe the

Deﬁned element

Is deﬁned as

Optional; can be omitted

Previous element(s) may be repeated

Command and Query Structure

Commands consist of set commands and query commands (usually called commands and queries). Commands modify instrument settings or tell the instrument to perform a speciﬁc action. Queries cause the instrument to return

ata and status information.

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 commands have both a set and a query form. Some commands have set only and some have query only.

Messages

A command message is a command or query name followed by any information the instrument needs to execute the command or query. Command messages may contain ﬁve element types, deﬁned in the following table.

ACQuire:MODe has a query form ACQuire:MODe?.Notall

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-1

Command Syntax

Commands

Table 2-2: Comm

Symbol Meaning

<Argument

<Comma> A single c

<Space>

Comman

ds cause the instrument to perform a speciﬁc function or change one of

and Message Elements

This is the basic command name. If the header ends with a question mark, the command is a query. The header may begin with a colon (:) c haracte the beginning colon is required. Never use the beginning colon with command headers beginning with a asterisk (*).

This is a header subfunction. Some command headers have only one mnemonic. I character always separates them from each other.

This is a qu Some commands have no arguments while others have multiple arguments. A <space> separates arguments from the header. A <comma> se

commands. Optionally, there may be white space characters before and after the comma.

A white space character is used between a command header and the related argument. Optionally, a white space may consist of multiple white sp

r. If the command is concatenated with other commands,

f a command header has multiple mnemonics, a colon (:)

antity, quality, restriction, or limit associated with the header.

parates arguments from each other.

omma is used between arguments of multiple-argument

ace characters.

the settings. Commands have the structure:

[:]<H

eader>[<Space><Argument>[<Comma> <Argument>]...]

A command header consists of one or more mnemonics arranged in a hierarchical

ee structure. The ﬁrst mnemonic is the base or root of the tree and each

or tr 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.

2-2 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Syntax

Queries

Headers

Queries cause t

he instrument to return status or setting information. Queries

have the structure:

[:]<Header>?

[:]<Header>?[<Space><Argument> [<Coma><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 sp

eciﬁed branch or level. For example, HIStogram:STATistics:STDdev? returns the standard deviation of the histogram, while HIStogram:STATistics? returns all the histogram statistics, and HIStogram? returns all the histogram parameters.

You can control whether the ins trument 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, then 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. The

wing table shows the difference in responses.

follo

Table 2-3: Comparison of Header Off and Header On Responses

Query Header Off Header On

TIME?

ACQuire:NUMAVg?

”14:30:00” :TIME”14:30:00”

100

:ACQUIRE:NUMAVG 100

Clearing the Instrument

You can clear the Output Queue and reset the instrument to accept a new command or query by using the selected Device Clear (DCL) GPIB function. Refer to your GPIB library documentation for further details about the selected Device Clear operation.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-3

Command Syntax

Command Entry

The following rules apply when entering commands:

You can enter commands in upper or lower case.

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 instrument ignores commands consisting of any combination of white space characters and line feeds.

Abbreviating

atenating

Conc

You can abbreviate many instrument commands. Each command in this documentation shows the abbreviations in capitals. For example, you can enter the command ACQuire:NUMAvg simply as ACQ:NUMA or acq:numa.

Abbreviation rules may change over time as new instrument models are introduced. Thus, for the most robust code, use the full spelling.

If you use the HEADer 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 with the VERBose command.

You can concatenate any combination of set commands and queries using a semicolon (;). The instrument executes concatenated commands in the order received.

2-4 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Syntax

When concatena

ting commands and queries, you must follow these rules:

1. Separate completely different headers by a semicolon and by the beginning

colon on all co

TRIGger:MODe NORMal and ACQuire:NUMAVg 10, can be concatenated

mmands except the ﬁrst one. For example, the commands

into the following single command:

TRIGger:MODe NORMal;:ACQuire:NUMAVg 10

2. If concaten

ated commands have headers that differ by only the last mnemonic, you can abbreviate the second command and eliminate the beginning colon. For example, you can concatenate the commands

ACQuire:MODe ENVelope

and ACQuire:NUMAVg 10 into a single command:

ACQuire:MODe ENVelope; NUMAVg 10

The longer version works equally well:

ACQuire

:MODe ENVelope;:ACQuire:NUMAVg 10

3. Never precede a star (*) command with a colon:

ACQuire:MODe ENVelope;*OPC

Any commands that follow will be processed as if the star command was not there so the commands,

ACQuire:MODe ENVelope;*OPC;NUMAVg 10 will

set the acquisition mode to envelope and set the number of acquisitions for

aging to 10.

aver

4. When you concatenate queries, the responses to all the queries are catenated into a single response message. For example, if the display

con imageview color is temperature and the display recordview color is spectral, the concatenated query

RECORDVIEW?

will return the following.

DISplay:COLOr:PALETTE:IMAGEVIEW?;

If the header is on:

:DISPLAY:COLOR:PALETTE:IMAGEVIEW TEMPERATURE; :DISPLAY:COLOR:PALETTE:RECORDVIEW SPECTRAL

If the header is off:

TEMPERATURE;SPECTRAL

5. Set commands and queries may be concatenated in the same message. For

example,

ACQuire:MODe SAMple;NUMAVg?;STATE?

is a valid message that sets the acquisition mode to sample. The message then queries the number of a cquisitions for averaging and the acquisition state. Concatenated commands and queries are executed in the order received.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-5

Command Syntax

Terminating

Here are some in

DISplay:PERSistance:RESET;ACQuire:NUMAVg 10 (no colon before

valid concatenations:

ACQuire)

er;

DISplay:GRAticule FULl;:FILTer SINX (extra colon before FILT DISplay:GRAticule FULl;FILTer S INX instead)

DISplay:PERSistance:RESET;:*OPC (colon before a star (*) command)

DISplay:COLOr:MATHCOLOr DEFAULT;COLOr:REFCOLOr INHERIT (levels

of the mnemonics are different; either remove the second use of

:DISPlay: in front of COLOr:REFCOLOr INHERIT)

COLor or place

use

This documentation uses <EOM> (End of message) to represent a message terminator.

Table 2-4: End of Message Terminator

Symbol Meaning

<EOM>

Message terminator

The end-of-message te rminator must be the END message (EOI asserted concurrently with the last data byte). The last data byte may be an ASCII linefeed (LF) character.

This instrument does not support ASCII LF only message termination. The instrument always terminates outgoing messages with LF and EOI.

Constructed Mnemonics

Some header mnemonics specify one of a range of mnemonics. For example, a channel mnemonic can be 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:POSition command, and there is also a CH2:POSition command. In the command descriptions, this list of choices is abbreviated as CH<x>.

Cursor Position

Mnemonics

When cursors are displayed, commands may specify which cursor of the pair to use.

Table 2-5: Cursor Mnemonics

Symbol Meaning

CURSOR<x>

POSITION<x>

HPOS<x>

A cursor selector; <x> is either 1 or 2.

2-6 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Syntax

Math Speciﬁer Mnemonics

Measurement Speciﬁer

Mnemonics

Channel Mnemonics

Commands can sp

ecify the mathematical waveform to use as a mnemonic in

the heade r.

Table 2-6: Math Speciﬁer Mnemonics

Symbol Meaning

Math<x>

Commands can specify

A math waveform speciﬁer; <x> is 1 through 4.

which measurement to set or query as a mnemonic in the

header. Up to e ight automated measurements may be displayed.

Table 2-7: Measurement Speciﬁer Mnemonics

Symbol Meaning

MEAS<x> A measurement speciﬁer; <x> is 1 through 8.

Commands specify the channel to use as a mnemonic in the header.

Table 2-8: Channel Mnemonics

Symbol Meaning

CH<x> A channel speciﬁer; <x> is 1 through 4.

Reference Waveform

Mnemonics

Argument Types

Numeric

Commands can specify the reference waveform to use as a mnemonic in the header.

Table 2-9: Reference Waveform Mnemonics

Symbol Meaning

REF<x>

A reference waveform speciﬁer; <x> is 1 thru 4.

Many instrument commands require numeric arguments. The syntax shows the format that the instrument returns i

n response to a query. This is also the preferred format when sending the command to the instrument though any of the formats will be accepted. This documentation represents these arguments as follows:

Table 2-10: Numeric Arguments

Symbol Meaning

<NR1>

<NR2> Floating point value without an exponent

<NR3> Floating point value with an exponent

Signed integer value

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-7

Command Syntax

Quoted String

Most numeric ar

guments 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.

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 ("). The following is an example of a quoted string:

string"

. This documentation represents these arguments as follows:

"This is a quoted

Table 2-11: Quoted String Argument

Symbol Meaning

<QString> Quoted string of ASCII text

A quoted string can include any character deﬁned in the 7-bit ASCII character set. Follow these rules when you use quoted strings:

1. Use the same type of quote character to open and close the string. For

example:

"this is a valid string".

2. You can mix quotation marks within a string as long as you follow the

previous rule. For example,

"this is an ’acceptable’ string".

3. You can include a quote character within a string by repeating the quote. For

example:

"here is a "" mark".

Block

4. Strings can have upper or lower case characters.

5. If you use a GPIB network, you cannot terminate a quoted string with the

END message before the closing delimiter.

6. A carriage return or line feed embedded in a quoted string does not terminate

the string, but is treated as just another character in the string.

7. The maximum length of a quoted string returned from a query is 255

characters.

Here are some invalid strings:

"Invalid string argument’ (quotes a re not of the same type)

"test<EOI>" (termination character is embedded in the string)

Several instrument commands use a block argument form (see the following table).

Table 2-12: Block Argument

Symbol Meaning

<NZDig>

<Dig>

A nonzero digit character in the range of 1–9

A digit character, in the range of 0–9

2-8 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Syntax

Table 2-12: Block Argument (cont.)

Symbol Meaning

<DChar> A character with the hexadecimal equivalent of 00 through FF (0

through 255 decimal)

<Block>

A block of data bytes deﬁned as: <Block> ::= {#<NZDig><Dig>[<Dig>...][<DChar>...] |#0[<DChar>...]<terminator>}

<NZDig> s

peciﬁes the number of <Dig> elements that follow. Taken together, the <NZDig> and <Dig> elements form a decimal integer that speciﬁes how many <DChar> elements follow.

NOTE. The digit <NZDig> is in hexadecimal format. This deviates slightly from

the IEEE 488.2 speciﬁcation that it be in decimal format, as extra allowances must be made for data lengths that are greater than 999,999,999 <DChar> elemen

ts (for example 500M record lengths at 2 bytes per point).

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-9

Command Syntax

2-10 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

The programmable interface conforms to Tektronix standard codes and formats except where noted. The GPIB interface also conforms to IEEE Std 488.2-1987 except where

Acquisition Command Group

noted.

Use the com

mands in the Acquisition Command Group to set up the modes and functions that control how the instrument acquires the signals you input to the channels and processes them into waveforms.

Using these commands for acquiring waveforms, you can do the following:

Start and

stop acquisitions.

Control whether each waveform is simply acquired, averaged, or enveloped over suc

cessive acquisitions of that waveform.

Set the controls or conditions that start and stop acquisitions.

Determine the action the system takes upon completing an acquisition, such as saving all waveforms and taking a measurement when the acquisition is

ed.

stopp

Control acquisition of acquired channel waveforms.

Set acquisition parameters.

Table 2-13: Acquisition Commands

Command Description

ACQuire?

ACQuire:INTERPEightbit Sets or returns the interpolation acquisition

ACQuire:MODe Sets or returns acquisition mode

ACQuire:NUMFRAMESACQuired? Returns the number of acquisitions that have

ACQuire:NUMACq? Returns the number of waveform acquisitions

ACQuire:NUMAVg Sets or returns number of acquisitions for an

ACQuire:NUMEnv Sets or returns number of acquisitions for

ACQuire:NUMSAMples Sets or returns the number of samples that

Returns acquisition parameters

mode

occurred

that have occurred since starting acquisition with the ACQuire:STATE RUN command

averaged waveform

envelope waveform

make up a WfmDB for single sequence mode and Mask Pass/Fail Completion Test

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-11

Command Groups

Alias Command Group

Table 2-13: Acquisition Commands (cont.)

Command Description

ACQuire:SAMPlingmode

ACQuire:STATE Starts, stops, or returns acquisition state

ACQuire:STOPAfter Sets or returns whether the acquisition is

FASTAcq? Enables, disables, or returns state of Fast

FASTAcq:HIACQRATE Sets or returns the state of FastAcq

FASTAcq:STAT E

This command sets or queries the sampling mode

continuous or single sequence

Acquisition mode

optimization for capturing the details with a higher sample rate

Returns the Fast Acquisition state

Alias commands allow you to deﬁne new commands as a sequence of standard commands. You may ﬁnd this useful when repeatedly using the same commands to perform certain tasks like setting up measurements.

Aliases are similar to macros but do not include the capability to substitute parameters into alias bodies. The alias mechanism obeys the following rules:

ThealiasnamemustconsistofavalidIEEE 488.2 message unit, which may not appear in a message preceded by a colon, comma, or a command or query program he ader.

Thealiasnamemaynotappearinamessage followed by program date, a colon, comma, or question mark.

An alias name must be distinct from any keyword or keyword short form.

An alias name cannot be redeﬁned without ﬁrst being deleted using one of the alias deletion functions.

Alias names do not appear in response messages.

TheAliascommandsaredeﬁned in Tektronix Standard Codes and Formats. Deviations between that standard and what is speciﬁed here will be considered errors unless speciﬁcally noted in the command

description in this document.

Table2-14: AliasCommands

Command Description

ALIas

ALIas:CATalog? Returns a list of the currently deﬁned alias

Sets or returns the alias state

labels

2-12 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Table 2-14: Alias Commands (cont.)

Command Description

ALIas:DEFine

ALIas:DELEte

ALIas:DELEte:ALL Deletes all existing aliases

ALIas:DELEte:NAMe

ALIas:STATE Sets or returns the alias state

Calibration Command Group

The Calibration commands provide information about the current state of instrument calibration and allow you to initiate internal signal path calibration (SPC). Commands that are speciﬁc to factory calibration are not described in this manual; however, they are described in the service manual (located on your

duct Software CD-ROM in PDF format). You can also order a printed copy

Pro (see Recommended Accessories in the online help for the instrument).

Command Groups

Assigns a sequence of program messages to an alias label

Removes a speciﬁed alias

Command

CALibrate? Returns the internal and factory calibration

*CAL? Instructs the instrument to perform

CALibrate:CALProbe:CH<x>? Performs a probe calibration for the selected

CALibrate:INTERNal Starts the internal signal path calibration

CALibrate:INTERNal:STARt Starts the i nternal signal path calibration

CALibrate:INTERNal:STATus? Returns the current status of the internal

CALibrate:PRObestate:CH<x>? Returns the probe calibration status for the

CALibrate:RESults? Returns the status of all calibration

CALibrate:RESults:SPC? Returns the results of the last SPC operation

Cursor Command Group

Description

status

self-calibration and returns the calibration status when complete

channel and returns the calibration status

signal path calibration

probe of the selected channel

subsystems without performing an SPC operation

Use the commands in the Cursor Command Group to control the cursor display and readout. You can use these commands to control the setups for cursor 1 and cursor 2, such as waveform source, cursor position, and cursor color.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-13

Command Groups

You can also use

the commands to select one of the following cursor functions:

Off. Shuts off the display of all cursors.

Vertical Bars. Displays vertical bar cursors, which provide traditional

horizontal unit readouts for Cursor 1 (bar1), Cursor 2 (bar2), the delta between them, and 1/delta (results in frequency when the horizontal unit is time).

Horizontal Bars. Displays horizontal bar cursors, which provide traditional vertical unit readouts for Cursor 1 (bar1), Cursor 2 (bar2), and the delta between them.

Waveform Cursors. Consists of two cursors you can independently assign to a waveform. These cursors provide the same readouts that the vertical and horizontal bar cursors provide. Waveform cursors enable you to conveniently measure waveform amplitude and time. In XY or XYZ format, waveform cursors indicate the amplitude position of an XY pair (Ch1 vs Ch2 voltage, where Ch1 is the X axis and Ch2 is the Y axis) relative to the trigger.

Screen Cursors. Consists of two pairs of independent horizontal and vertical cursors. You can use these cursors to indicate an arbitrary position within the waveform display area. Screen cursors, depending on the style selected, consist of the intersection of a vertical and horizontal line, an X, or a vertical line with an X. These c

ursors have no association with any waveform, other

than they inherit the color of the waveform they are assigned too.

Command

CURSor?

CURSor:FUNCtion Sets or returns the cursor type

CURSor:HBArs?

CURSor:HBArs:DELTa? Returns hbars cursors vertical difference

CURSor:HBArs:POSITION<x> Sets or r eturns the hbar cursor<x> vertical

CURSor:HBArs:UNIts?

CURSor:LINESTyle Sets or returns the cursor line style

CURSor:MODe Sets or returns whether cursors move in

CURSor:SCREEN:STYle Sets or returns the cursor type for screen

CURSor:SCREEN:XPOSITION<x> Sets or queries the x position of the speciﬁed

CURSor:SCREEN:YPOSITION<x> Sets or queries the y position of the speciﬁed

CURSor:SOUrce<x> Sets or returns the source for cursor <x>

CURSor:STATE Turns cursors on or off or returns their state

CURSor:VBArs Sets or returns the position of vertical bar

Description

Returns all cursor settings

Returns hbar cursor settings

position

Returns hbar cursor units

unison or separately

mode

screen cursor

cursors

2-14 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

CURSor:VBArs:DELTa? Returns the difference between vbar cursors

CURSor:VBArs:POSITION<x> Sets or returns the vbar cursor<x> horizontal

CURSor:VBArs:POS<x> Sets or queries the horizontal position for

CURSor:VBA

CURSor:WA

CURSor:WAVEform:HDELTA? Returns the horizontal difference between

CURSor:WAVEform:HPOS<x>? Returns the position of waveform cursor <x>

CURSor:WAVEform:POSition<x> Sets or returns the position of w aveform

CURSor

CURSor:WAVEform:UNIts Sets or returns the units for waveform cursors

CURSor:WAVEform:VDELTA? Returns the vertical difference between

CURSor:XY? Returns the current settings for XY cursors

CURSor:XY:PRODDELta? Returns the product of the difference

CURSor:XY:PRODUCT<x>? Returns the product of the X and Y positions

CURSor:XY:RADIUS<x>? Returns the radius of the speciﬁed cursor

CURSor:XY:RATDELta? Returns ratio of the difference between the

CURSor:XY:RATIO<x>? Returns ratio of the X (horizontal) and Y

CURSor:XY:RDELta?

CURSor:XY:READOUT Sets or returns the XY cursor readout mode

CURSor:XY:RECTX<x> Sets or returns the X cursor position in

CURSor:XY:RECTY<x> Sets or returns the Y cursor position in

CURSor:XY:THDELta?

CURSor:XY:THETA<x>?

CURSor:XY:XDELta?

CURSor:XY:YDELta?

rs:UNIts

VEform

:WAVEform:STYle

Description

position

vertical ba

Sets o r retu

Sets or ret waveform cursors

waveform cursors

cursor

Sets o r mode

waveform cursors

bet positions

for the speciﬁed cursor

ursors X position and Y position

(vertical) position for the speciﬁed cursor

Returns the Dr value

rectangular coordinates

Returns the XY cursor angle delta in polar coordinates

Returns the XY cursor angle in polar coordinates

Returns the XY cursor ΔX value in rectangular coordinates

Returns the XY cursor ΔY value in rectangular coordinates

rcursors

rns the units for vbar cursors

urns the current settings for

<x>

returns the cursor type for waveform

ween the cursors X positions and Y

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-15

Command Groups

Diagnostics C

ommand Group

The Diagnostic commands control the selection and execution of diagnostic tests.

Command

DIAg:CONTROL:HALT Enables or disables halting on ﬁrst diagnostic

DIAg:CONTROL:LOOP Enables or disables looping of diagnostics

DIAg:FAILURES:CLEAR Sets and returns the clearing of pass/fail

DIAg:EXECUTE Executes currently selected set of diagnostics

DIAg:ITEM?

DIAg:ITEM:FAILURES? Returns the total number of failures that

DIAg:ITEM:NAMe? Returns the name of the selected menu item

DIAg:ITEM:RESULT? Returns the results of the last test executed

ITEM:SUBITEMS?

DIAg:

:LEVEL

DIAg

DIAg:LOOPS? Returns the number of times the diagnostics

Ag:NAMe?

Ag:NAMe:AREA?

DIAg:NAMe:SUBSYS? Returns the subsystem of the current

DIAg:NAMe:TEST? Returns the name of the current diagnostic

DIAg:NUMITEMS? Returns the number of items on the currently

DIAg:RESults? Returns a brief pass or fail status of the last

DIAg:RESults:VERBose?

DIAg:SELect:ALL Selects all available diagnostics

DIAg:SELect:AREA Selects one of the available diagnostic areas

DIAg:SELect:LAST Sets the last item of a group of items from

Description

failure

informati Event Log, at the start of diagnostic tests

Returns a menu item

occurred

on thi

Retur with this item

Sets the current level of diagnostic test hierarchy

wer

Returns the subsystem name, area, and test na

Re diagnostic test

diagnostic test

test

selected level of test hierarchy

test execution

Returns a more explanatory message about the results of the last diagnostic execution

the same level of test hierarchy

on from data structures, not the

ll data associated with a selected

sitem

ns the number of subitems associated

e completed during the last execution

me of the current diagnostic test

turns the selected area of the current

2-16 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Displa

Command

DIAg:SELect:SUBSYS Selects one of the available diagnostic

DIAg:SELect:TEST Selects one of the available diagnostic tests

DIAg:STATE Sets the instrument operating state

DIAg:STOP Terminates the execution of diagnostics

TEST Selects and executes an item at any level

TEST:RES

TEST:RESults:VERBose?

TEST:STOP Terminates the execution of the test

ults?

y Control Command Group

Use the commands in the Display Control Command Group to change the graticule style, the displayed intensities, and to set the characteristics of the

orm display.

wavef

You can set the display of date and time; cursor, histogram, mask, and

urement readouts; measurement annotations, and the mode in which

meas waveforms are displayed.

Description

subsystems

of the test

Returns a test execution

Returns a the results of the last test execution

hierarchy

brief pass or fail status of the last

more explanatory message about

re are six color palettes from which you can select:

The

Normal. Displays hues and lightness levels for best overall viewing.

Tem p . Displays areas of the waveform with the highest sample density in

warmer colors (red shades) while the areas of lowest sample density appear in

ooler colors (blue shades).

Spectral. Displays areas of the waveform with the highest sample density in

lue shades while the areas of lowest sample density appear in red shades.

Green. Displays waveforms in shades of green. Areas of the waveform with the highest sample density appear in lighter green shades while the areas of lowest sample density appear in darker green shades.

Gray. Displays waveforms in shades of gray. Areas of the waveform with the highest sample density appear in lighter gray shades while the areas of lowest sample density appear in darker gray shades.

User Allows you to create a customized color palette.

Use the commands to set the style that best displays your waveforms and graticule display properties.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-17

Command Groups

NOTE. The mode y

Command

DISplay?

DISplay:CLOCk Sets or returns the display of the date/time

DISplay:COLOr?

DISplay:COLOr:MATHCOLOr Sets or returns the color to be used for m ath

DISplay:

DISplay:COLOr:PALEtte:RECORDView Sets or returns the color palette for

DISplay:COLOr:PALEtte:USEr

DISplay:COLOr:PALEtte:USEr:CARet Sets or returns the user caret color

DISplay:COLOr:PALEtte:USEr:CH<x> Sets or returns the user palette channel

DISpl

DISp

DISplay:COLOr:PALEtte:USEr:MASK Sets or returns the user palette mask color

DISplay:COLOr:PALEtte:USEr: MASKHighlight

DISplay:COLOr:PALEtte:USEr:MATH<x> Sets o r returns the user palette math colors

DISplay:COLOr:PALEtte:USEr:REF<x> Sets or returns the user palette reference

DISplay:COLOr:REFCOLOr Sets or returns the color to be used for

DISplay:FILTer Sets or returns the type of interpolation to

DISplay:FORMat Sets or returns the display format

DISplay:GRAticule Sets or returns the type of graticule that is

DISplay:INTENSITy? Returns the waveform and graticule

DISplay:INTENSITy:WAVEform:IMAGEView Sets o r returns the waveform saturation level

DISplay:INTENSITy:WAVEform: RECORDView

DISplay:PERSistence Sets or returns display persistence setting

COLOr:PALEtte:IMAGEView

ay:COLOr:PALEtte:USEr:GRAticule

lay:COLOr:PALEtte:USEr:HIStogram

ISplay:COLOr:PALEtte:USEr:WAVEform

ou choose globally affects all displayed waveforms.

Description

Returns curre

stamp

Returns color group settings

traces

Sets or re waveforms

recordview waveforms

Returns the user palette group settings

color

Sets o

or returns the user palette histogram

Sets color

Sets or returns the user palette mask hits color

olors

ets or queries the user palette waveform

S colors

reference traces

use for the display

displayed

saturation levels

for imageview waveforms

Sets o r returns the waveform saturation level for recordview waveforms

nt display settings

turns the color palette for imageview

r returns the user palette graticule

2-18 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

DISplay:PERSistence:RESET Clears the persistence data

DISplay:SCREENTExt?

DISplay:SCREENTExt:LABel<x>? Sets or returns the screen text setting for a

DISplay:SCREENTExt:LABel<x>: FONTCOlor

DISplay:S FONTNAme

DISplay:SCREENTExt:LABel<x>:FONTSIze Sets or queries the screen text label font size

DISplay:SCREENTExt:LABel<x>: FONTSTy

DISpla

DISplay:SCREENTExt:LABel<x>:XPOS Sets or returns the horizontal position of a

DISplay:SCREENTExt:LABel<x>:YPOS Sets or returns the vertical position of a given

DISp

DISplay:SHOWREmote Sets or queries the state of the remote

ISplay:TRIGBar

DISplay:TRIGT Sets or returns the display of the trigger point

DISplay:VARpersist Sets or returns the persistence decay time

DISplay:WAVEform Sets or returns the display of waveform

CREENTExt:LABel<x>:

y:SCREENTExt:LABel<x>:NAMe

y:SCREENTExt:LABel<x>:STATE

lay:SCREENTExt:STATE

Splay:STYle

Description

Returns all sc

given label

Sets or queries the screen text label font color

Sets or que name for a given label

for a given label

Sets or queries the screen text label font style fo

Sets th

Sets o r a given label

given label

labe

or returns the state of the display of

Sets screen text

display feature and is equivalent to selecting

splay Remote from the Display menu

ts or returns data display style

ets or returns the display setting of the

S trigger level indicator bar(s)

indicator

traces

reen text settings

ries the screen text label font

r a given label

e text to be displayed for a given label

queries the screen text label state for

E-mail Command Group

Commands in the E-mail group allow you to send e-mail to one or more designated recipients whenever a selected event, such as a trigger, mask test failure (Option MTM only), o r a limit test failure occurs in the instrument.

Using this feature, you do not have to continually monitor the instrument for the event.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-19

Command Groups

When an event oc

curs, the instrument will send an SMTP mail message to one or more designated recipients through the speciﬁed mail server. The message can include any of the following:

Screen image

Waveform da

Measurement data at the time of the event

NOTE. Yo u r

instrument must be connected to the Local Area Network (LAN) using Transfer C Protocol/Internet Protocol (TCP/IP). The recipient must also have an SMTP mail server. To send e-mail for a mask test failure, you must have Mask Testing (Option MTM) installed.

Command

EMail:ATTempts

EMail:AUTHLogin

EMail:AUTHPassword

EMail:COUNt? Returns the number of e-mails that have

EMail:FROm Sets o r queries the From line in the e-mail

EMail:HOSTwanted Sets or queries the hostname that will be

EMail:IMAGe Sets or queries w hether image data is

EMail:MASK Sets or queries whether e-mail is sent when

EMail:MAXSize Sets or queries the maximum size (in

EMail:MEASUrement Sets or queries whether measurement data

EMail:NUMEMails

EMail:SMTPPort Sets or queries the SMTP port number that

Description

Sends a test e-mail message or sets the current e-mail sent count to zero

Sets or queries the number of times that an attempt will be made to send e-mail to the SMTP e-mail server

Sets or queries the login name that will be used if the SMTP e-mail server requires one for authentication

Sets the password that will be used if the SMTP e-mail server requires one for authentication

been sent since Email on Event was armed

used when e-mail is sent to the SMTP e-mail server

included in the e-mail

a mask test failure occurs

megabytes) of e-mail that can be sent to the SMTP server

is included in the e-mail

Sets or queries the number e-mails that can be sent when Email onEvent is armed

the e-mail server uses

2-20 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

EMail:SMTPServer Sets or queries the address of the SMTP

EMail:STATUS? Queries the status of e-mail

EMail:TIMEOut Sets or queries the global timeout in seconds

EMail:TO Sets or queries the address of the

EMail:TRIGger Sets or queries whether e-mail is sent when

EMail:WAVEform Sets or queries whether waveform data is

File System Command Group

Use the commands in the File System Command Group to help you use the built-in hard disk drive. You can use the commands to do the following:

List the contents of the default directory

Create and delete directories

Description

mail server

recipient( are separated with a semicolon (;)

a trigger occurs

included

s) of an e-mail. Multiple addresses

in the e-mail

te, copy, read, rename, or delete a ﬁle

Crea

When using these commands, keep the following points in mind:

File arguments are always enclosed within double quotes: “C:\MYDIR\TEK00001.SET”

File names follow the MSDOS format: [DRIVE:][\PATH\]ﬁlename

Path separators may be either forwardslashes(/)orbackslashes(\)

NOTE. Using back slash as a path separator may produce some unexpected

results, depending on how your controller application treats escaped characters.

any applications recognize the sequence of back slash followed by an alphabetic

M character as an escaped character, and, as such, interpret that alphabetic character as a control character. For example, the sequence “\n” may be interpreted a s a newline character; “\t” may be interpreted as a tab character. To ensure that this interpretation does not occur, you can use double back slashes. For example, “C:\\testﬁle.txt”.

Some FILESystem commands may fail because a ﬁle has read-only attributes. You will not be able to delete or replace such ﬁles until this attribute is removed. Refer to the operating system help on ﬁle properties for further information.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-21

Command Groups

Command

FILESystem? Returns the ﬁle system state

FILESystem:COPy Copies one or more ﬁles to a new ﬁle

FILESystem:CWD Sets or returns the current working directory

FILESystem:DELEte Deletes a named ﬁle or directory

FILESystem:DIR? Returns a list of directory c ontents

FILESystem:MKDir

FILESystem:PRInt Prints a named ﬁle to the named port

FILESystem:READFile Copies the named ﬁle to the GPIB port

FILESystem:REName Assigns a new name to an existing ﬁle

FILESystem:RMDir

FILESystem:WRITEFile Copies the GPIB port block data to a named

Hard Copy Command Group

Hard Copy commands enable you to make hard copies of data ﬁles or send the data to a speciﬁed ﬁle. In addition, these commands provide you with information about (and the ability to set) ﬁle path settings.

Description

for FILESystem GPIB commands

Makes a new directory

Deletes the named directory

ﬁle

cription

Command

ort

EXP

EXPort:FILEName

EXPort:FORMat Sets or returns the export image format

EXPort:PALEtte

EXPort:READOuts Sets or returns the position of the readouts

EXPort:VIEW

HARDCopy Sends a screen copy to the selected port or

HARDCopy:FILEName Sets or returns the hard copy ﬁ le path

HARDCopy:LAYout Sets or returns the page orientation for hard

HARDCopy:PALEtte Sets or returns the hard copy color palette

HARDCopy:PORT Sets or returns whether the hard copy data

Des

Copies a waveform to a speciﬁed ﬁle or returns formatting and ﬁle information

Sets or returns the export ﬁle path

Sets or returns the export color palette

for export

Sets or returns the export screen capture area

returns the selected port and ﬁle path

copy

will be sent to a ﬁle or printed on the next hard copy command

2-22 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

HARDCopy:READOuts Sets or returns the position of the readouts

HARDCopy:VIEW Sets or returns the area of the screen to be

Histogram Command Group

Histogram commands let you select the type of histogram, what part of the waveform should go into the histogram, and histogram statistics. Use commands from this group to do the following:

Create a histogram of vertical or horizontal values for a channel, math, or reference waveform

Adjust the limits of the waveform area from which the histogram data is obtained

Clear histogram count and restart

Retrieve the histogram data

Comma

gram?

HISto

ogram:BOX

HISt

HIStogram:BOXPcnt Sets or returns same as HIStogram:BOX, but

HIStogram:COUNt Clears histogram count source data and

HIStogram:DATa? Returns a comma-separated list of histogram

IStogram:DISplay

HIStogram:FUNCtion Sets the type of histogram to create

HIStogram:MODe Sets type of histogram to create or turns

HIStogram:SIZe Sets or returns the width (or height) of the

Description

for hardcopy

hardcopied

Description

Returns all histogram parameters

or returns the left, top, right, and bottom

Sets positions of the histogram box, in source waveform coordinates

ercentage coordinates, with 0,0 upper left

in p and 100,100 lower right

restarts counting

ata numbers

ets or returns whether histogram data is

S displayed and the current display type setting

Or returns the current histogram type

histograms off

Or returns the current histogram type or that histogram display is disabled

histogram on the screen in divisions

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-23

Command Groups

Command

HIStogram:SOUrce Sets or returns which source waveform will

HIStogram:S

Horizontal Command Group

Horizontal commands control the time bases of the instrument. You can set the time per division (or time per point) of the main time base. You can use the Horizontal commands to do the following:

Set the scale, horizontal position and reference, and units of the time base

Get the screen resolution, time of ﬁrst point and time of last point, or get all the horizontal settings

Enable or disable the display of the time base

You may substitute SECdiv for SCAle in the horizontal commands. This provides program compatibility with earlier models of Tektronix instruments.

TATE

Description

be compared against the histogram box when the histo

Sets or retur calculations are enabled

gram testing is enabled

ns whether histogram

Command

HORizontal? Returns all learnable settings for the

HORizontal:ACQDURATION?

HORizontal:ACQLENGTH?

HORizontal:DIVisions? Returns the number of graticule divisions

HORizontal:FASTframe? Returns all settings for the horizontal

HORizontal:FASTframe:COUNt Sets or returns the FastFrame frame count

HORizontal:FASTframe:MAXFRames? Returns the maximum number of FastFrame

HORizontal:FASTframe:MULtipleframes: FRAMESTart:<wfm>

HORizontal:FASTframe:MULtipleframes: MODe

HORizontal:FASTframe:MULtipleframes: NUMFRames:<wfm>

Description

horizontal commands

Returns the time base duration

Returns the record length

over which the waveform is displayed

FastFrame commands

Sets or returns the horizontal record length to the number of sample points in each frame

frames which can be acquired at the current frame length

Sets or returns the start frame number on the speciﬁed waveform for FastFrame multiple frames

Sets or returns the mode for FastFrame multiple frames

Sets or returns the number of frames on the speciﬁed waveform for FastFrame multiple frames

2-24 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

HORizontal:FASTframe:REF:FRAme Sets or returns the FastFrame reference

HORizontal:FASTframe:REF:SOUrce Sets or returns the FastFrame Reference

HORizontal

HORizontal:FASTframe:SELECTED: MATH<x>

HORizontal:FASTframe:SELECTED: REF<x>

HORizont SOUrce

HORizontal:FASTframe:SEQuence Sets or returns the FastFrame source

HORizontal:FASTframe:STATE Sets or returns the state of FastFrame

HORiz

HORiz <wfm>?

HORizontal:FASTframe:TIMEStamp: BETW

HORizontal:FASTframe:TIMEStamp:DELTa: <wfm>?

HO FRAMe:<wfm>?

HORizontal:FASTframe:TIMEStamp:REF? Returns the absolute trigger date and time for

HORizontal:FASTframe:TIMEStamp: SELECTED:<wfm>?

HORizontal:FASTframe:TRACk Sets up or returns the state of FastFrame

HORizontal:FASTframe:XZEro:ALL:CH<x>? Returns the time from the trigger to the start

HORizontal:FASTframe:XZEro:ALL: REF<x>?

:FASTframe:SELECTED:CH<x>

al:FASTframe:SELECTED:

ontal:FASTframe:SUMFrame

ontal:FASTframe:TIMEStamp:ALL:

een:<wfm>?

Rizontal:FASTframe:TIMEStamp:

Description

frame number

waveform sou

Sets or retu frame number on the speciﬁed waveform

Sets or returns the FastFrame selected frame number on the speciﬁed waveform.

Sets or returns the FastFrame selected frame num

Sets or re waveform

waveform

acquis

Sets o

ns the frame number and time stamp

Retur for each frame between requested frames, inclusive, within the speciﬁed waveform

Returns the relative trigger for the delta time

een the speciﬁed frames, within the

betw speciﬁed waveform

urns the relative time between the

Ret triggers of the FastFrame Selected and the FastFrame Reference, within the speciﬁed

eform

wav

Returns the absolute trigger date and time

r the speciﬁed frame and waveform

the FastFrame speciﬁed reference waveform

Returns the absolute trigger date and time for the F astFram e Selected, within the speciﬁed waveform

tracking

of the speciﬁed frames on the speciﬁed channel

Returns the time from the trigger to the start of the speciﬁed frames on the speciﬁed reference

rce

rns the FastFrame selected

ber on the speciﬁed waveform

turns the FastFrame source

ition

r returns the summary frame mode

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-25

Command Groups

Command

HORizontal:FASTframe:XZEro:FRAme: CH<x>?

HORizontal: REF<x>?

HORizontal:FASTframe:XZEro:REF? Sets or returns the time from the trigger to the

HORizonta CH<x>?

HORizontal:FASTframe:XZEro:SELECTED: REF<x>?

HORizon

HORizontal[:MAIn]:DELay:MODe Sets or returns the main time base trigger

HORizontal[:MAIn]:DELay:POSition Sets or returns the main time base position

HORiz

HORizontal:MAIn:INTERPRatio?

HORizontal[:MAIn]:POSition Sets or returns the waveform horizontal

HORizontal:MAIn:UNIts Sets or returns the units for the horizontal

Rizontal:MAIn:UNIts:STRing

HORizontal:MODE Sets or queries the horizontal mode. Auto

HORizontal:MODE:AUTO:LIMITrecordlen Sets or queries the record length limit used

HORizontal:MODE:RECOrdlength Sets or queries the record length

HORizontal:MODE:SAMPLERate Sets or queries the sample rate

HORizontal:MODE:SCAle Sets or queries the horizontal scale

HORizontal:ROLL Sets or returns the horizontal roll mode status

HORizontal:TIMEStamp:CH<x>?

HORizontal:TIMEStamp:REF<x>?

FASTframe:XZEro:FRAme:

l:FASTframe:XZEro:SELECTED:

tal:MAIn?

ontal[:MAIn]:DELay:TIMe

Description

Returns the time from the trigger to the start of the speciﬁed frame on the speciﬁed channel

Returns the t start of the speciﬁed frame on the speciﬁed reference

trigger sam

Sets or ret the trigger sample on the selected channel

Sets or returns the time from the trigger to the trigger sample on the selected reference waveform

Returns time base

delay mode

when H

Sets o delay time

rns the main horizontal time base

Retu interpolation ratio

position on the display

e base

tim

ts or returns the units string for the

Se horizontal main time base trigger delay

mode is the factory default

by the auto horizontal mode

Returns the absolute trigger date and time for the speciﬁed frame and waveform

Returns the absolute trigger date and time for FastFrame reference

ime from the trigger to the

ple on the reference waveform

urns the time from the trigger to

the time per division of the main

orizontal Delay Mode is turned off

r returns the main time base trigger

2-26 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Limit Test Com

mand Group

Use the commands in the Limit Test Command Group to perform limit testing by selecting channel, math, or reference waveforms and comparing them against a template wa

Command

LIMit? Returns all settings for the Limit commands

LIMit:BEEP

LIMit:COMpare

LIMit:COMpare:CH<x> Sets or queries the template against which

COMpare:MATH<x>

LIMit:

LIMit:COMpare:REF<x> Sets or queries the template against which to

LIMit:EMail

LIMit:HARDCopy Sets or queries whether a hard copy

Mit:HIGHLIGHTHits

IMit:HIGHLIGHTHits:RESet

IMit:LOCk

LIMit:LOG Sets or queries whether a log ﬁle is saved

LIMit:SAVEWFM Sets or queries whether the source waveform

LIMit:SAVEWFM:FILEName Sets or queries the path where waveforms

veform.

Description

Causes the instrument to beep when the waveform d limit test

Resets th

to compare the waveform acquired from the channel

Sets or compare the math waveform speciﬁed by x

compare the reference waveform speciﬁed by x

Sets o generated when the source waveform data exceeds the limits speciﬁed for the limit test

ope any waveform data exceeds the limit set in the lim it test. L IM it:STATE must be set to ON

the hard copy operation to execute

for

ts or queries whether violation highlighting

Se occurs when limit testing is active, and, if the RESET argument is set, clears the

ghlighting

esets the hits highlighting for limit testing

ets or queries whether vertical scaling and

S positioning affect both source and template for template comparison pairs

when the source waveform data exceeds the test limits

is saved when the source waveform data exceeds the test limits

or log ﬁles will be saved when the waveform data exceeds the limits set by the limit test

ata exceeds the limits set in the

e l im it test comparison template

speciﬁed by x

queries the template against which to

r queries w hether an E-mail is

ration is executed on the waveform when

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-27

Command Groups

Command

LIMit:SRQ Sets or queries whether a Service Request

LIMit:STATE Sets limit te

LIMit:STATus? Queries the state of limit testing

LIMit:STOPOnviolation Sets or queries whether acquisitions are

LIMit:TE

LIMit:TEMPlate:TOLerance:HORizontal Sets or queries the amount, in units of

LIMit:TEMPlate:TOLerance:VERTical Sets or queries the amount, in units of

LIMit:TEMPlate:DESTination Sets or queries destination reference

LIMit:TEMPlate:SOUrce Sets or queries the channel, math

MPlate:STORe

Description

Interrupt (SRQ) is generated when the waveform data

limittestingisineffect

stopped when the waveform data exceeds the test li

Saves the speciﬁed reference or ﬁle name

horizontal divisions, by which the source wavefor creating the destination waveform

vertical divisions, by which the source

rm is varied vertically when creating

wavefo the destination waveform

waveform that the limit template

form, or reference w aveform that the

wave

LIMit:TEMPlate:STORe command will use

falls outside of the test limits

sting on or off or queries w hether

mits

speciﬁed source waveform to the

m is varied horizontally when

Low

Speed Serial Trigger Command Group

DPO7000 Series only: Use the commands in the Low Speed Serial Trigger Command Group to control serial triggering for the instrument. CAN trigger

mmands are only available with the CAN option.

Command

TRIGger:A:CAN:CONDition Sets or returns the CAN condition

TRIGger:A:CAN:DATa:DIRection Sets or queries the CAN trigger condition to

TRIGger:A:CAN:FORMat Sets or queries the CAN data format

TRIGger:A:CAN:DATa:LEVel Sets or queries the CAN Trigger threshold

TRIGger:A:CAN:DATa:SOUrce Sets or queries the CAN data s ource

TRIGger:A:CAN:DATa:VALue Sets or queries the binary data string used

TRIGger:A:CAN:FRAMEtype Sets or queries the CAN trigger frame type

Description

be valid on a READ, WRITE, or either

for the CAN data source

for CAN Trigger if the trigger condition is ID or IDANDDATA

2-28 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

TRIGger:A:CAN:IDENTiﬁer:MODe Sets or queries the CAN trigger identiﬁer

TRIGger:A:CAN:IDENTiﬁer:VALue Sets or queries the binary address string

TRIGger:A:CAN:PROBE Sets or queries the probing method used to

TRIGger:A:CAN:SPEed Sets or queries the bit rate of the CAN

TRIGger:

TRIGger:A:I2C:ADDRess:RWINClude Sets or queries the I2C address mode to

TRIGger

TRIGge

TRIGger:A:I2C:CLOCk:LEVel Sets or queries the clock s ource for the I2C

TRIG

TRIGger:A:I2C:CONDition Sets or queries the trigger condition for the

TRIGger:A:I2C:DATa:DIRection Sets or queries the I2C trigger condition valid

TRIGger:A:I2C:DATa:SOUrce Sets or queries the data source for the I2C

TRIGger:A:I2C:DATa:STARt Sets or queries the data start byte

TRIGger:A:I2C:DATa:VALue Sets or queries the binary data string used

TRIGger:A:I2C:FORMat Sets or queries the display format for the I2C

TRIGger:A:RS232:BAUd Sets or queries the baud rate for RS232

TRIGger:A:RS232:DATa:LEVel Sets or queries the threshold for the RS232

TRIGger:A:RS232:DATa:SOUrce Sets or queries the RS232 data source

TRIGger:A:RS232:DATa:VALue Sets or queries the binary data string used

A:I2C:ADDRess:MODe

:A:I2C:ADDRess:TYPe

r:A:I2C:ADDRess:VALue

ger:A:I2C:CLOCk:SOUrce

IGger:A:I2C:DATa:LEVel

Description

mode

used for the C condition is ID or IDANDDATA

probe the CAN signal

system

Sets or qu or 10-bit

include the read/write bit as an additional 8th bitofth

Sets or q

Sets or used for the I2C trigger if the trigger condition is ADDR or ADDRANDDATA

l Trigger

Seria

or queries the clock source for the I2C

Sets Serial Trigger

I2C trigger

a READ, WRITE, or either

ts or queries the threshold level for the

Se I2C data source

serial trigger

for I2C triggering if the trigger condition is DATA or ADDRANDDATA

data value

triggering

data source

for RS232 triggering

AN trigger if the trigger

eries the I2C address mode to 7

e 7–bit address

ueries the I2C address type

queries the binary address string

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-29

Command Groups

Command

TRIGger:A:RS232:FORMat Sets or queries the display format for the

TRIGger:A:RS232:PARity Sets o r queries the state of the RS232 parity

TRIGger:A:

TRIGger:A

TRIGger:

TRIGger:A:SERIAL:CODe Sets or queries the signal code

TRIGger:A:SERIAL:DATa:FORMat Sets or queries how the Pattern string is

TRIGger:A:SERIAL:DATa:PATtern Sets or queries the data pattern to allow up

TRIGg

TRIGger:A:SERIAL:DATa:PATtern:S8B10B Sets or queries the data pattern to allow up

TRIGger:A:SERIAL:LOCKLen Sets or queries the length in bits of the

TRI

TRIGger:A:SERIAL:SOUrce Sets or queries the serial data source

TRIGger:A:SERIAL:STANdard Sets or queries the standard that identiﬁes

RIGger:A:SERIAL:TRIGgeron

TRIGger:A:SPI:CONDition Sets or queries the trigger condition for SPI

TRIGger:A:SPI:DATa:MISO:ACTIVE Sets or queries the SPI MISO polarity

TRIGger:A:SPI:DATa:MISO:LEVel Sets or queries the threshold for the SPI

TRIGger:A:SPI:DATa:MISO:SOUrce Sets or queries the MISO data source for the

TRIGger:A:SPI:DATa:MISO:VALue Sets or queries the binary data string used

TRIGger:A:SPI:DATa:MOSI:ACTIVE Sets or queries the SPI M OSI polarity

TRIGger:A:SPI:DATa:MOSI:LEVel Sets or queries the threshold for the SPI

SERIAL:BITRate

SERIAL:CLOCk:LEVel

:SERIAL:CLOCk:POLarity

A:SERIAL:CLOCk:SOUrce

er:A:SERIAL:DATa:PATtern:NRZ

Gger:A:SERIAL:LOCKOffset

Description

RS232 data value

bit

Sets or quer

Sets or que

Sets or qu channel

formatted

to 64 bi

Sets o to 64 bit serial patterns

to 64 bit serial patterns

repe

s or queries the current bit offset into the

Set pattern lock trigger bit pattern

channel

he code and bit rate

ets or queries the trigger on a designated

S arbitrary bit pattern or lock on a repeating pattern of known length

triggering

MISO data source

SPI trigger

for the SPI trigger if the trigger condition is set to M ISO or MISOMOSI

MOSI data source

ies the clock/data bit rate

ies the serial trigger clock level

ries the serial clock polarity

eries the serial data source

t serial patterns

r queries the data pattern to allow up

ating bit pattern for pattern lock trigger

2-30 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

TRIGger:A:SPI:DATa:MOSI:SOUrce Sets or queries the MOSI data source for the

TRIGger:A:SPI:DATa:MOSI:VALue Sets or queries the binary data string used

TRIGger:A:SPI:DATa:STARt Sets or queries the nth data byte on the data

TRIGger:A:SPI:FORMat Sets or queries the SPI trigger data format

TRIGger:A:SPI:SCLK:ACTIVE Sets or queries the SPI SCLK polarity

TRIGger:A:SPI:SCLK:LEVel Sets or queries the threshold for the SPI

TRIGger:A:SPI:SCLK:SOUrce Sets or queries the SPI SCLK source

TRIGger:A:SPI:SS:ACTIVE Sets or queries the SPI trigger Slave Select

er:A:SPI:SS:LEVel

TRIGg

TRIGger:A:SPI:SS:SOUrce Sets or queries the SPI trigger Slave Select

Description

SPI trigger

for the S PI tr settoMOSIorMISOMOSI

source after the signal on the enable slave source swit the Slave Select Polarity

trigger SCLK

(SS) po

Sets o trigger Slave Select (SS) signal

(SS) source

igger if the trigger condition is

ches to the polarity speciﬁed by

larity

r queries the threshold for the SPI

Mask Command Group

the commands in the Mask Command Group to compare incoming waveforms

Use against standard or user-deﬁned telecommunications masks. Standard masks are only available when option MTM is installed. Without option MTM, you need to deﬁne your masks. When the instrument detects waveforms that fall inside or outside of the mask limits, it can perform tasks such as generating hard copy, saving the waveform, emitting a beep or an SRQ, stopping and waiting for your

nput, sending an E-mail messa ge with speciﬁed data, logging the time/date of the

i acquired waveform, or some combination of these actions.

A mask is a set of polygonal regions on the screen. Every vertical line of the screen intersects the polygon in zero, one, or two places, but never in more than two places. (A vertical line that intersects a vertical mask border is counted.) You have to break up more complicated polygons into two separate segments. Unlike limit testing, the inside of a mask is the region where waveform data would not normally fall. A telecommunications standard requires up to eight of these segments. Pulse standards always have two segments. Standards with eye patterns usually have three masks, but some have four.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-31

Command Groups

You use th e co mm

ands in the Mask Command Group to do the following:

Specify the waveform source to test and the mask to use.

Specify whether to use, and the size of, mask margins, which allow you to shrink or expand an existing set of polygons by a speciﬁed percentage.

Specify whether to display a readout of hits and the mask on screen. Options also exist for auto ﬁtting the incoming waveforms to match the mask you choose.

Select industry-standard masks that support a variety of electrical and optical communica

tion standards (available only with option MTM).

Deﬁne and edit your own custom mask; create an entirely new mask, or use astandar

d mask (option MTM only) as a s tarting reference, and edit it to

meet your needs.

Enable,

disable, or reset the m ask counts. Once y ou turn on mask counting, it

remains on until you explicitly turn it off.

Option

MTM also provides communication trigger commands that you can use in conjunction with the mask commands, such as TRIGger:A:TYPe Communication. Refer to the Trigger Command Group.

Comma

MASK

MASK:AUTOAdjust Optimizes signal position within the mask to

MASK:AUTOAdjust:HDELTA Sets or returns how far autoﬁt searches

MASK:AUTOSet:AUTOAdjust Controls what happens at the end of a mask

MASK:AUTOSet:HPOS Controls whether the algorithm will attempt to

MASK:AUTOSet:HSCAle Controls whether the algorithm will attempt to

MASK:AUTOSet:MODe Controls whether an autoset will be

SK:AUTOAdjust:VDELTA

Description

rns the states of all settable mask

Retu parameters

minimize hits

rizontally

ts or returns how far autoﬁt searches

Se vertically

autoset. If ON, the horz/vert auto adjustment

s run ONCE to potentially improve the result

i of mask autoset

change the horizontal position of the signal while attempting to autoset

change the horizontal scale while attempting to autoset

automatically done after a standard mask is selected

2-32 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

MASK:AUTOSet:OFFSETAdj Sets autoset not to enforce the rule that,

MASK:AUTOSet:STANdard Selects the standard mask in autoset

MASK:AUTOSet:TRIGger Controls if a MASK:AUTOSet affects the

MASK:AUTOSet:USER:ONE Sets or returns the level 1 used by autoset

MASK:AUT

MASK:AU

MASK:AUTOSet:VPOS Controls whether the autoset algorithm will

MASK:

MASK:COPy:USER Copies the currently displayed mask to the

MASK

MASK:COUNt:FAILURES? Returns the number of pass/fail tests that

MASK:COUNt:HITS? Returns the total number of mask hits on all

ASK:COUNt:SEG<m>:HITS?

MASK:COUNt:STATE Sets or returns the m ask hits count state

MASK:COUNt:TESTS? Returns the number of pass/fail tests that

MASK:COUNt:TOTal? Returns the sum of all hits in all mask

MASK:COUNt:VIOLATIONS? Returns the number of test violations that

MASK:COUNt:WAVEFORMS? Returns the number of waveforms that

MASK:DISplay Sets or returns whether the deﬁ ned masks

OSet:USER:TYPe

TOSet:USER:ZERo

AUTOSet:VSCAle

:COUNt

Description

for pulse standards, requires 0 V to be in a certain place will attempt to measure the DC offset in the signal and use scope offset or position controls to c the signal

trigger level

foruserm

Sets o r re

Sets or r forusermasks

affect the vertical position (or offset) of the signal

Contr attempt to change the vertical scale while attempting to autoset

User

Rese segments on the speciﬁed source

have failed

sk segments

eturns the number of hits in mask segment

R <m>

have occurred

segments

have occurred in the current pass/fail test

have been acquired and processed during pass/fail testing

are displayed on the screen

in the mask. Instead, autoset

ompensate for the DC offset in

asks

turns how autoset scales a mask

eturns the level 0 used by autoset

while attempting to autoset

ols whether the autoset algorithm will

mask

ts to zero the number of hits for all mask

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-33

Command Groups

Command

MASK:FILTer Sets or returns whether the selected optical

MASK:HIGHLIGHTHits Sets or returns whether the hits in a mask

MASK:INVert Controls whether the mask is drawn inverted

MASK:LOCk Sets or returns the mask lock to waveform

MASK:MARgin:PERCent Sets or queries the mask margin percentage

MASK:MARgin:STATE Sets or returns the state of the mask margins

MASK:MASKPRE:AMPlitude Sets or returns the current mask’s nominal

MASK:M

MASK:MASKPRE:HTRIGPOS Sets or returns the nominal trigger position

MASK:MASKPRE:PATTERNBITS Sets or returns the number of bits used for

MASK:MASKPRE:PRESAMPBITS Sets or returns the number of bits before

MASK:MASKPRE:RECOrdlength Sets or returns the nominal record length for

MASK:MASKPRE:TRIGTOSAMP Sets or returns the time, in seconds, from the

MASK:MASKPRE:VOFFSet Sets or returns the nominal vertical offset,

MASK:MASKPRE:VPOS Sets or returns the nominal vertical position,

MASK:MASKPRE:VSCAle Sets or returns the nominal vertical scale, in

MASK:MASKPRE:WIDth Sets or returns the nominal bit width in

MASK:POLarity Sets or returns the input waveform polarity

MASK:SEG<m> Deletes the speciﬁed mask segment from

ASKPRE:HSCAle

Description

reference receiver mask ﬁlter is enabled

are highligh waveform data

mode

pulse am

Sets or resolution used to draw the current mask, in time/division

(puls mask as a fraction of the display width

serial trigger for the current mask standard

the ( serial trigger pass/fail testing

pulse mask testing

eading edge) trigger position to the pulse

(l bit sampling position

in volts, used to vertically offset the input

hannels

in divisions, used to vertically position the input channels

volts per division, used to vertically scale the input channels

seconds

for the pass/fail test

the Current mask

ted in different colors than other

plitude in volts

returns the nominal timing

e leading edge) used to draw the current

isolated one) pulse leading edge in the

2-34 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

MASK:SEG<m>:NR_Pt? Returns the number of points that make up

MASK:SEG<m>

MASK:SOUrce Sets or reports which source will be

MASK:STAN

MASK:STO

MASK:TES

MASK:TESt:AUX:FAILure Sets or returns the test:aux status on

MASK:TESt:BEEP:COMPLetion Sets or returns the beep on pass/fail test

TESt:BEEP:FAILure

MASK:

MASK:TESt:DELay Sets or returns the amount of time, in

:TESt:HARDCopy

MASK

MASK:TESt:LOG:FAILure Sets or returns the log status on pass/fail

MASK:TESt:REPeat Sets or returns the repeat pass/fail test on

ASK:TESt:SAMple

MASK:TESt:SAMple:THReshold Sets or returns the minimum number of hits in

MASK:TESt:SAVEWFM Sets or returns the save waveform to ﬁle on

MASK:TESt:SAVEWFM:FILEName Sets or returns the name of the directory and

MASK:TESt:SRQ:COMPLetion Sets or returns an SRQ on pass/fail test

:POINTS

dard

POnviolation

t:AUX:COMPLetion

Description

the speciﬁed mask segment of the Current mask

Sets or retur all points in the Current mask segment

compared against the mask(s) when counting is

Deletes the existing mask and sets the selected s

Sets o r re

Sets or re completion mode

pass/fail test failure mode

comple

Sets o test failure mode

seconds, to wait after starting pass/fail

ing to evaluate waveforms

test

Sets failure mode

test failure mode

mpletion mode

ets or returns the minimum number of

S waveform database (WfmDB) points the instrument can acquire before it stops a

ingle sequence acquisition or stops running

s a mask test

mask regions needed to cause the pass/fail status to change from PASSING to FAILING

failure setting

ﬁle to use with the MASK:TESt:SAVEWFM command

completion mode

ns the X-Y user coordinates of

turned on

tandard mask

turns the stop on violation setting

turns the test:aux on pass/fail test

tion mode

r returns the beep status on pass/fail

or returns the hard copy in pass/fail

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-35

Command Groups

Command

MASK:TESt:SRQ:FAILure Sets or returns the SRQ status on pass/fail

MASK:TESt:STATE Sets or returns the state of mask pass/fail

MASK:TESt:

MASK:TESt:THReshold Sets or returns the number of failed tested

MASK:TESt:WAVEform Sets or returns the number of waveforms to

MASK:USER:AMPlitude Sets or returns the current mask’s nominal

MASK:U

MASK:

MASK:USER:HTRIGPOS Sets or returns the nominal trigger position

MASK

MASK:USER:PATTERNBITS Sets or returns the number of bits used for

MASK:USER:PRESAMPBITS Sets or returns the number of bits before

MASK:USER:RECOrdlength Sets or returns the nominal record length for

MASK:USER:SEG<m> Deletes the speciﬁed mask segment from

MASK:USER:SEG<m>:NR_Pt? Returns the number of points that make up

MASK:USER:SEG<m>:POINTS Sets or returns the X-Y user coordinates of

MASK:USER:TRIGTOSAMP Sets or returns the time, in seconds, from the

MASK:USER:VOFFSet Sets or returns the nominal vertical offset,

STATUS?

STOP:FAILure

SER:BITRate

USER:HSCAle

:USER:LABel

Description

test failure mode

testing

Returns the

Sets or retu test failure mode

waveforms needed in each pass/fail test to cause the PASSING to FAILING

test during pass/fail testing

pulse am

Sets o r

Sets o used to draw the mask, in time/division

(pulse leading edge) used to draw the mask as a f

Sets mask

serial trigger for the User mask standard

e (isolated one) pulse leading edge in the

th serial trigger pass/fail testing

pulse mask testing

the User mask

the speciﬁed User mask segment

all points in the speciﬁed User mask segment

(leading edge) trigger position to the pulse bit sampling position

in volts, used to vertically offset the input channels

pass/fail test status

rns the stop status on pass/fail

pass/fail status to change from

plitude in volts

returns the user mask’s bit rate

r returns the nominal timing resolution

raction of the display width

or returns the label assigned to a user

2-36 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Math Command Group

Command

MASK:USER:VPOS Sets or returns the nominal vertical position,

MASK:USER:V

MASK:USER:WIDth Sets or returns the nominal bit width in

RECAll:MA

SAVe:MAS

SCAle

Description

in divisions, used to vertically position the input channel

Sets or retur volts per division, used to vertically scale the input channels

seconds

Recalls a stored mask as the User mask

Saves the

ns the nominal vertical scale, in

User mask to a mass storage ﬁle

Use the commands in the Math Command Group to create and deﬁne math waveforms. You can deﬁne and display up to four math waveforms simultaneously on four channel models and up to two on two channel models. Use the available math functions to deﬁne your math waveform.

The math waveform you create depends on s ources listed in the math expression. If you change these sources, the math waveforms you previously deﬁned will be affected.

Math expressions can be simple, containing no mathematical computation, such as CH1, which speciﬁes that a waveform shows the signal source of channel 1. Math expressions can also be complex, consisting of 100 plus characters and comprising many sources, functions, and operands.

The acquisition of a live waveform can stop for several reasons: You can turn off the channel, stop the waveform (via Run/Stop from the Horiz/Acq menu), or stop the trigger (via Run/Stop from the Trig menu). When you turn off the channel, math continues and data is acquired but is not displayed. When you stop either the waveform or the trigger, the math calculation s tops, and the last math calculation performed is displayed.

When a live waveform update or reference waveform is altered, math waveforms containing those waveforms as sources are also updated to reﬂect the changes. Also, sources must exist but do not need to be displayed to be used in and to update math waveforms.

Command

MATH<x >? Returns the speciﬁed math waveform

MATH<x>:DEFine

MATH<x>:FILTer:MODe Sets or returns the ﬁlter rise time parameter

Description

settings

Sets or returns the math<x> waveform deﬁnition for the speciﬁed waveform

(centered or shifted)

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-37

Command Groups

Command

MATH<x>:FILTer:RISetime Sets or returns the ﬁlter rise time parameter

MATH<x>:LABe

MATH<x>:LABel:XPOS Sets or returns the X screen offset where the

MATH<x>:LA

MATH<x>:N

MATH<x>:

MATH<x>:SPECTral:CENTER Sets or returns the center frequency of the

MATH<x>:SPECTral:GATEPOS Sets or returns the position of the center of

x>:SPECTral:GATEWIDTH

MATH<

MATH<x>:SPECTral:LOCk Sets or returns the state of the spectral

MATH<x>:SPECTral:MAG Sets or returns the units of the SpectralMag

H<x>:SPECTral:PHASE

MAT

MATH<x>:SPECTral:REFLevel Sets or returns the vertical position of the

MATH<x>:SPECTral:REFLEVELOffset Sets or returns the spectral reference level

ATH<x>:SPECTral:RESBw

MATH<x>:SPECTral:SPAN Sets the top of the frequency span to a value

MATH<x>:SPECTral:SUPPress Sets or returns the phase suppression

MATH<x>:SPECTral:UNWRap Enables or disables or returns the state of

MATH<x>:SPECTral:WINdow Sets or returns the window function used

l:NAMe

Bel:YPOS

UMAVg

SPECTral?

Description

Sets or returns the label string used for annotating the displayed math waveform

math wavefo

Sets or retu math waveform label is displayed

Sets or returns the acquisition number at which the averaging algorithm will begin exponent

Returns t spectral setups

spectral analyzer output data span

the gat

Sets o spectral analyzer

locking for the speciﬁed math waveform

tion in the speciﬁed math string

func

s or returns the units of the SpectralPhase

Set function in the speciﬁed math string

output data from the spectral analyzer

ffset used for calculating the dB value

ets or returns the resolution bandwidth of

S the spectral analyzer

that is closest to the speciﬁed value

Or returns the speciﬁed math waveform’s current frequency span value

threshold

the phase unwrap of the spectral analyzer output data

to multiply the input data to the spectral analyzer

rm label is displayed

rns the Y screen offset where the

ial averaging

he speciﬁed math waveform

r returns the gate width input to the

2-38 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

MATH<x>:UNITString Sets or returns the units used for the math

MATH<x>:VER

MATH<x>:VERTical:SCAle Sets or returns the speciﬁed math waveform

MATHArbﬂt<x>:FILepath Sets the ﬁle path for a ﬁle of ﬁlter coefﬁcients

MATHArbﬂ

MATHVAR? Sets or returns all 8 numerical values you

MAT H VAR:VAR< x>

t<x>:READFile

Measurement Command Group

Use the commands in the Measurement Command Group to control the automated measurement system.

Tical:POSition

Description

waveform; command overrides the default unit string

Sets o r retur vertical position

vertical scale (per div)

and reads t

Forces a r speciﬁed arbitrary ﬁlter

can use within math expressions

Sets or returns a numerical value you can use with

ns the speciﬁed math waveform

he ﬁle

eread of the ﬁlter ﬁle for the

in math expressions

Up to eight automated measurements can be displayed on the scr een. In the commands, these measurement readouts are named MEAS<x>, where <x> can be 1 through 8.

In addition to the eight displayed measurements, the measurement commands let you specify an additional measurement, IMMed. The immediate measurement has no front panel equivalent. Immediate measurements are never displayed.

cause they are computed only when needed, immediate measurements slow the

Be waveform update rate less than displayed measurements.

hether you use displayed or immediate measurements, use the VALue query to

W obtain measurement results.

Measurement commands can set and query measurement parameters. You can assign parameters, such as waveform sources and reference levels, differently for each measurement.

Command

MEASUrement?

MEASUrement:ANNOTation:IMMEDSTAte Sets or returns the state of immediate

MEASUrement:ANNOTation:NUMX? Returns the number of horizontal

Description

Returns all measurement parameters

measurement annotation

measurement annotati ons being displayed

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-39

Command Groups

Command

MEASUrement:ANNOTation:NUMY? Returns the number of vertical measurement

MEASUrement:ANNOTation:STATE Sets or returns the state of visible

MEASUremen

MEASUrement:ANNOTation:X<x>? Returns the value of the speciﬁed annotation

MEASUrement:ANNOTation:Y<x>? Returns the value of the speciﬁed annotation

MEASUrement:GATing Sets or returns the measurement gating

MEASUrement:IMMed?

MEASUrement:IMMed:DELay? Returns information about the immediate

MEASUrement:IMMed:DELay:DIREction Sets or returns the search direction to use

MEASU

MEASUrement:IMMed:DELay:EDGE2 Sets or returns the slope of the edge

MEASUrement:IMMed:METHod Speciﬁes or queries the method used to

ASUrement:IMMed:NOISe

MEASUrement:IMMed:REFLevel? Returns the reference levels

MEASUrement:IMMed:REFLevel:ABSolute: HIGH

MEASUrement:IMMed:REFLevel:ABSolute: LOW

MEASUrement:IMMed:REFLevel:ABSolute: MID<x>

MEASUrement:IMMed:REFLevel:METHod Sets or returns the method used to calculate

MEASUrement:IMMed:REFLevel:PERCent: HIGH

MEASUrement:IMMed:REFLevel:PERCent: LOW

MEASUrement:IMMed:REFLevel:PERCent: MID<x>

t:ANNOTation:TYPe

rement:IMMed:DELay:EDGE[1]

Description

annotations being displayed

measurement

Sets o r retu used

Returns a parameters

delay measurement

for imm

Sets o used for immediate delay “from” waveform measurements

for immediate delay “to” waveform

used measurements

calculate the 0% and 100% reference level

immediate measurements

for

ts or returns the location of the noise

Se measurement on the eye waveform

Sets or returns the high reference level

Sets or returns the low reference level

Sets o r returns the middle reference levels

measurements

Sets or returns the top level for rise time (90% level)

Sets or returns the low level for rise time (10% level)

Sets or r eturns the mid levels for measurements

annotations

rns the type of annotations being

ll immediate measurement setup

ediate delay measurements

r returns the slope of the edge

2-40 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

MEASUrement:IMMed:SOUrce<x> Sets or returns the source to measure “to”

MEASUrement

MEASUrement:IMMed:TYPe Sets or returns the type of the immediate

MEASUrement:IMMed:UNIts? Returns the units of the immediate

MEASUrem

MEASUrement:MEAS<x>? Returns all measurement parameters for the

MEASUrement:MEAS<x>:COUNt? Returns the number of values accumulated

MEASUr

MEASU

MEASUrement:MEAS<x>:DELay:EDGE<x> Sets or returns the slope of the edge

Urement:MEAS<x>:MAXimum?

MEAS

MEASUrement:MEAS<x>:MEAN?

MEASUrement:MEAS<x>:METHod Sets or returns the method used to calculate

MEASUrement:MEAS<x>:MINImum? Returns the minimum value found since the

EASUrement:MEAS<x>:NOISe

MEASUrement:MEAS<x>:REFLevel? Returns the reference levels

MEASUrement:MEAS<x>:REFLevel: ABSolute:HIGH

MEASUrement:MEAS<x>:REFLevel: ABSolute:LOW

MEASUrement:MEAS<x>:REFLevel: ABSolute:MID<x>

MEASUrement:MEAS<x>:REFLevel: METHod

MEASUrement:MEAS<x>:REFLevel: PERCent:HIGH

:IMMed:SOUrce<x>:SIGType

ent:IMMed:VALue?

ement:MEAS<x>:DELay?

rement:MEAS<x>:DELay:DIREction

Description

or “from” for phase or delay immediate measurements

Sets or retur for the speciﬁed measurement source

measurement

measureme

Returns t measurement

displayed measurement

since th

Returns the delay measurement parameters for spe

Sets o for delay measurements

to use for delay “from” or “to” waveform meas

Retu last statistical reset

urns the mean value accumulated since

Ret the last statistical reset

the 0% and 100% reference level

ast statistical reset

ets or returns the location of the noise

S measurement on the eye waveform for MEAS<x>

Sets or returns the top level for rise time (90% level)

Sets or returns the low level for rise time (10%)

Sets or returns the mid1 or mid2 level for measurements

Sets or returns the reference level units used for measurement calculations

Sets or returns the top level for rise time (90% level)

ns the type of input signal used

he value of the immediate

e last statistical reset

ciﬁed measurement

r returns the search direction to use

urements

rns the maximum value found since the

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-41

Command Groups

Command

MEASUrement:MEAS<x>:REFLevel: PERCent:LOW

MEASUrement:MEAS<x>:REFLevel: PERCent:MID

MEASUremen

MEASUrement:MEAS<x>:SOUrce<x>: SIGType

MEASUrem

MEASUrement:MEAS<x>:STDdev? Returns the standard deviation of values

MEASUre

MEASUr

MEASU

MEASUrement:NOISe Sets or returns the location of the noise

MEASUrement:REFLevel:ABSolute:HIGH Sets or returns the top reference level for

ASUrement:REFLevel:ABSolute:LOW

MEASUrement:REFLevel:ABSolute:MID<x> Sets or returns the mid1 or m id2 reference

MEASUrement:REFLevel:METHod Sets or r eturns the method for assigning high

MEASUrement:REFLevel:PERCent:HIGH Sets or returns the top reference percent

MEASUrement:REFLevel:PERCent:LOW Sets or returns the low reference percent

MEASUrement:REFLevel:PERCent:MID<x> Sets or returns the mid1 or mid 2 reference

MEASUrement:SOUrce<x>:SIGType Sets or returns the type of input signal used

MEASUrement:STATIstics:COUNt Clears existing measurement statistics from

<x>

t:MEAS<x>:SOUrce<x>

ent:MEAS<x>:STATE

ment:MEAS<x>:TYPe

ement:MEAS<x>:UNIts?

rement:MEAS<x>:VALue?

rement:METHod

Description

Sets or returns the low level for rise time (10% level)

Sets or returns the mid1 or mid2 level for delay measur

Sets o r retu or “to” for phase or delay measurements

Sets or returns the type of input signal used for the speciﬁed measurement source for the speciﬁed m

Sets or re measurement slot is computed and displayed

accumul

Sets o r r

Returns measurement<x> units

Retur

Sets o calculating reference levels

measurement on the eye waveform

etime

ris

ts or returns the low reference level for

Se rise time

level for measurements

nd low reference levels

level for rise time

percent level for waveform measurements

for the speciﬁed measurement source

memory

ements

rns the source to measure “from”

easurement slot

turns whether the speciﬁed

ated since the last statistical reset

eturns the measurement<x> type

ns the value of measurement<x>

r returns the method used for

2-42 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

MEASUrement:STATIstics:MODe Turns measurement statistics on or off

MEASUrement

Miscellaneous Command Group

Miscellan

Several commands a nd queries are common to all 488.2-1987 devices on the GPIB bus. commands begin with an asterisk (*) character.

Command

AUXout?

AUXout:EDGE Sets or returns the direction in which the

AUXout:SOUrce Sets or returns the trigger source at the BNC

AUTOSet Sets the vertical, horizontal, and trigger

BELl In previous models, this command sounded

CMDBatch Turns command batching on or off

DATE

*DDT Sets or returns the commands that will be

HEADer

HDR

ID? Returns identifying information about the

*IDN? Returns the instrument identiﬁcation code

LOCk Sets or returns the front panel lock state

*LRN? Returns a listing of instrument settings

eous commands do not ﬁt into other categories.

Description

and sets or returns which pair of statistical

s is displayed

ns the ’time constant’ for

:STATIstics:WEIghting

accumulation

Sets or retur mean and standard deviation statistical accumulations

The 488.2-1987 standard deﬁnes these commands. The common

Description

Returns the auxiliary out setup

trigger output signal will transition when a trigger occurs

connection

controls of the instrument to automatically acquire and display the selected waveform

the audio indicator. Provided for backward compatibility

Or returns the state of command batching

Sets or returns the date that the instrument can display

executed by the group execute trigger

Sets or returns the Response Header Enable State

instrument and its ﬁrmware

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-43

Command Groups

Command

NEWpass

PASSWord Provides access for changing user protected

REM

ROSc:SOUrce Sets or queries the selected source for the

ROSc:STATE? Returns whether the time base reference

ROSc:TRA

SET? Returns a listing of instrument settings

TEKSecure Initializes both waveform and setup

TIME

*TRG Performs the group execute trigger (GE T)

*TST? Tests the GPIB interface and returns status

UNLo

VER

Cking

Bose

Description

Changes the password for user protected data

data

Speciﬁes a c the instrument

time base reference oscillator

oscillat

Sets or qu time base reference oscillator. The reference oscillator locks to this source

memori

Sets o instrument

Unlocks front panel

Sets or returns the verbose state

omment, which is ignored by

or is locked

eries the selected source for the

r returns the time displayed by the

ve and Recall Command Group

UsethecommandsintheSaveandRecallCommand G roup to store and retrieve internal waveforms and settings. When you save a setup, you save all the settings

f the instrument. When you recall a setup, the instrument restores itself to the

o state that it was in when you originally saved that setting.

Command

*RCL Restores the state of the instrument from a

*SAV Stores the current instrument state to a

*SDS Changes the speciﬁed setup to reference the

DELEte:SETUp Removes stored setups from memory and

DELEte:WAVEform Deletes (one or all of) the stored reference

Description

copy of the setting stored in memory

speciﬁed memory location

factory s etup instead of the user setup

initializes the location with the factory default setups

waveforms from m emory

2-44 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

FACtory Resets the instrument to factory default

RECAll:SETUp

RECAll:SETUp:DESKew Sets or queries the deskew values that are

RECAll:WAV

SAVe:SETUp Saves the current front panel setup to a

SAVe:WAVEform Saves a waveform to one of four reference

SAVe:WA

SETUp:NAMe Sets or returns the user-deﬁned setup label

Eform

VEform:FILEFormat

and Mark Command Group

Use Search and Mark commands to seek out and identify information in waveform records that warrant further investigation.

Description

settings

Recalls saved instrument settings

affected by

Recalls a st location

speciﬁed memory location or ﬁle

memory lo

Sets or r waveforms

a default setup or a recalled setup

ored waveform to a reference

cations or a mass storage ﬁle

eturns the format for saved

Command

MARK

MARK:CREATE Creates a mark on a speciﬁ ed waveform or

MARK:DELEte

MARK:FREE? Returns how many marks are available for

MARK:SELected:END? Returns the end of the selected mark, 0 to

MARK:SELected:FOCUS? Returns the focus of the selected m ark , 0 to

MARK:SELected:LABel Set or queries the label for the selected mark

MARK:SELected:MARKSINCOLumn? Returns the number of marks in the current

MARK:SELected:OWNer? Returns the owner of the selected mark

MARK:SELected:SOURCE? Sets or returns the source waveform for the

MARK:SELected:STARt? Returns the starting point of the selected

Description

Moves to the next or previous reference mark, o r queries the current mark setup

all waveforms in a column

Deletes a mark on a particular waveform, all waveforms in a column, the selected mark, or all marks

use

100% of the waveform

zoom pixel column

selected mark

mark, 0 to 100% of the waveform

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-45

Command Groups

Command

MARK:SELected:STATe Returns the on or off state of the selected

MARK:SELect

MARK:SELected:ZOOm:SCAle? Returns the scale of the selected mark, 0 to

MARK:TOTal?

SEARCH:SEARCH<x> Converts the speciﬁed search marks to the

SEARCH:S

SEARCH:SEARCH<x>:STATE Selects which search is selected

SEARCH:SEARCH<x>:TOTAL? Returns the total number of matches for the

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:AUTOBitrate

SEARCH:SEARCH<x>:TRIGger:A: DDRM

SEAR DDRMemory:BITRate

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:CSActive

SEARCH:SEARCH<x>:TRIGger:A:

RMemory:CSLevel

EARCH:SEARCH<x>:TRIGger:A:

S DDRMemory:CSMode

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:CSSource

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:DATASource

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:HYSterisis

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:REFLevel:DATA:HIGH

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:REFLevel:DATA:LOW

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:REFLevel:DATA:MID

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:REFLevel:STROBE:HIGH

ed:ZOOm:POSition?

EARCH<x>:COPy

emory:AUTOReﬂevel

CH:SEARCH<x>:TRIGger:A:

Description

mark. The selected mark is at or near the center of the d

Returns the p to 100% of the zoom overview window

100% of the zoom overview window

Returns how many marks are currently in use

user mark

Copies th trigger criteria to a search, or copy search to search. <x> is the search number

search be more than the number of marks placed

Sets o r queries the auto bit rate setting

Sets or queries the auto reference levels

ing

sett

or queries the DDR memory bit rate

Sets

Sets or queries whether the expected chip-select will be an active HIGH or LOW

Sets or queries the DDR memory search

ip-select level

ets or queries the chip-select mode

Sets or queries the chip select source

Sets or queries the DDR memory data source

Sets or queries the hysterisis percent for DDR memory searches

Sets or queries the value of the data HIGH reference level

Sets or queries the value of the data LOW reference level

Sets or queries the value of the data MID reference level

Sets or queries the value of the strobe HIGH reference level

isplay

osition of the selected mark, 0

s. <x> can be 1 to 8

e search criteria to the trigger, the

. The total number of matches may

2-46 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:REFLevel:STROBE:LOW

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:R

SEARCH:SEA DDRMemory:STANdard

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:STROBEsource

SEARCH:SEARCH<x>:TRIGger:A:EDGE: SLOpe:CH

SEARCH:SEARCH<x>:TRIGger:A:EDGE: SLOpe:M

SEARCH:SEARCH<x>:TRIGger:A:EDGE: SLOpe:

SEARCH:SEARCH<x>:TRIGger:A:EDGE:

SOUrc

SEARCH:SEARCH<x>:TRIGger:A:GLItch: POLarity:CH<x>

RCH:SEARCH<x>:TRIGger:A:GLItch:

SEA POLarity:MATH<x>

ARCH:SEARCH<x>:TRIGger:A:GLItch:

SE POLarity:REF<x>

EARCH:SEARCH<x>:TRIGger:A:GLItch:

S TRIGIF

SEARCH:SEARCH<x>:TRIGger:A:GLItch: WIDth

SEARCH:SEARCH<x>:TRIGger:A:LEVel: CH<x>

EFLevel:STROBE:MID

RCH<x>:TRIGger:A:

<x>

ATH <x>

REF<x>

Description

Sets or queries the value of the strobe LOW reference level

Sets or queries the value of the strobe MID reference le

Sets or quer DDR Memory analysis search

Sets or queries the strobe source for a DDR Memory analysis search

Sets or returns the slope for an edge trigger search to <x> is the search number or the channel number

Sets or returns the slope for an edge trigger search t <x> is the search number or the m ath waveform number

Sets or returns the slope for an edge trigger search <x> is the search number or the reference waveform number

Sets or returns the source waveform for an edge t place a mark. <x> is the search number

Sets or returns the polarity for a glitch trigger search to determine where to place a mark. <x> i

s or returns the polarity for a glitch trigger

Set search to determine where to place a mark. <x> is the search number or math waveform

mber

ts or returns the polarity for a glitch trigger

Se search to determine where to place a mark. <x> is the search number or reference

aveform number

ets o r returns the accept or reject state for

S a glitch trigger search to determine where to place a mark. <x> is the search number

Sets or returns the glitch width for a glitch trigger search to determine where to place a mark. <x> is the search number

Sets or returns the level for an edge trigger search to determine where to place a mark. channel number. Each channel can have an independent level

vel

ies the DDR standard type for a

determine where to place a mark.

o determine where to place a mark.

to determine where to place a mark.

rigger search to determine where to

s the search number or channel number

<x> is the search number or the

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-47

Command Groups

Command

SEARCH:SEARCH<x>:TRIGger:A:LEVel: MATH<x>

SEARCH:SEARCH<x>:TRIGger:A:LEVel: REF<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: FUNCtion

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: INPut:CH

<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc:

MATH<x>

INPut:

SEARCH:SEARCH<x>:TRIGger:A:LOGIc:

:REF<x>

INPut

SEARCH:SEARCH<x>:TRIGger:A:LOGIc:

shold:CH<x>

THRe

RCH:SEARCH<x>:TRIGger:A:LOGIc:

SEA THReshold:MATH<x>

SEARCH:SEARCH<x>:TRIGger:A:LOGIc: THReshold:REF<x>

SEARCH:SEARCH<x>:TRIGger:A:PATtern: WHEn

SEARCH:SEARCH<x>:TRIGger:A:PATtern: WHEn:LESSLimit

Description

Sets or returns the math waveform level for an edge trigger search to determine where to place a mark

. <x> is the search number

or math waveform number

Sets or returns the speciﬁed reference waveform level for a trigger search to determin

SEARCH<x> is the search number and REF<x> is the reference channel number

ewheretoplaceamark.

Sets or returns the logic operator for a pattern or

state trigger search to determine where to place a mark. <x> is the search number

Sets or returns the Boolean logic criteria for a pattern wheretoplaceamark.

or state trigger search to determine

<x> is the search

number or the channel number

Sets or returns the Boolean logic criteria for

rn or state trigger search to determine

a patte where to place a mark. <x> is the search number or the math waveform number

Sets or returns the Boolean logic criteria for

ern or state trigger search to determine

a patt wheretoplaceamark.

<x> is the search

number or the reference channel number

Sets or returns the channel threshold

l for a pattern or state trigger search

leve to determine where to place a mark.

SEARCH<x> is the search number and

is the channel number

CH<x

s or returns the math waveform threshold

Set level for a pattern or state trigger search to determine where to place a mark. <x> is

search number or the Math waveform

the number

Sets or returns the reference waveform threshold level for a pattern or state trigger

earch to determine where to place a mark.

<x> is the search number or the reference

waveform number

Sets or queries the pattern trigger pattern test that determines where to place a mark.

<x> is the search number

Sets or queries the time the pattern trigger lesslimittestusesto determines where to place a mark.

<x> is the search number

2-48 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

SEARCH:SEARCH<x>:TRIGger:A:PATtern: WHEn:MORELimit

SEARCH:SEAR

CH<x>:TRIGger:A:PULse:

SOUrce

SEARCH:SEARCH<x>:TRIGger:A:RUNT: POLarity:CH<x>

SEARCH:SEARCH<x>:TRIGger:A:RUNT: POLarity:MATH<x>

SEARCH:SEARCH<x>:TRIGger:A:RUNT: POLarity:REF<x>

SEARCH:SEARCH<x>:TRIGger:A:RUNT: THReshold:HIGH:CH<x>

SEARCH:SEARCH<x>:TRIGger:A:RUNT: THReshold:HIGH:MATH<x>

SEARCH:SEARCH<x>:TRIGger:A:RUNT:

eshold:HIGH:REF<x>

THR

ARCH:SEARCH<x>:TRIGger:A:RUNT:

SE THReshold:LOW:CH<x>

EARCH:SEARCH<x>:TRIGger:A:RUNT:

S THReshold:LOW:MATH<x>

Description

Sets or queries the time the pattern trigger more limit test uses to determines where to place a mark.

Sets or retur

x> is the search number

ns the source waveform for a pulse trigger search to determine where to place a mark. <x> is the search number. This is the s

ource for Glitch, Width, Runt,

Timeout or Window searches.

Sets or returns the polarity setting for a runt trigger search to determine where to place a mark. <x> i

s the search number or channel

number

Sets or returns the polarity setting for a runt trigger search to determine where to place amark. <x

> is the search number or math

waveform number

Sets or returns the polarity setting for a runt trigger search to determine where to place a

x> is the search number or reference

mark. < waveform number

Sets or returns the channel threshold HIGH level for a runt trigger search to determine

to place a mark.

where

<x> is the search

number or the channel number

Sets or returns the math waveform threshold HIGH level for a runt trigger search to

rminewheretoplaceamark.

dete

<x> is

the search number or the math waveform number

Sets or returns the reference waveform

eshold HIGH level for a runt trigger

thr search to determine where to place a mark.

<x> is the search number or the reference

eform number

wav

ts or returns the channel threshold LOW

Se level for a runt trigger search to determine wheretoplaceamark.

umber or the channel number

ets or returns the math waveform threshold

<x> is the search

LOW level for a runt trigger search to determine where to place a mark.

<x> is

the search number or the math waveform number

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-49

Command Groups

Command

SEARCH:SEARCH<x>:TRIGger:A:RUNT: THReshold:LOW:REF<x>

SEARCH:SEARCH<x>:TRIGger:A:RUNT: WHEn

SEARCH:SEARCH<x>:TRIGger:A:RUNT: WIDth

SEARCH:S CLOCk:EDGE

SEARCH:SEARCH<x>:TRIGger:A:SETHold: CLOCk:S

SEARCH:SEARCH<x>:TRIGger:A:SETHold: CLOCk:THReshold:CH<x>

SEARCH:SEARCH<x>:TRIGger:A:SETHold: CLOCk:THReshold:MATH<x>

SEARCH:SEARCH<x>:TRIGger:A:SETHold: CLOCk:THReshold:REF<x>

SEARCH:SEARCH<x>:TRIGger:A:SETHold: DATa:SOUrce

ARCH:SEARCH<x>:TRIGger:A:SETHold:

SE DATa:THReshold:CH<x>

EARCH:SEARCH<x>:TRIGger:A:SETHold:

S DATa:THReshold:MATH<x>

SEARCH:SEARCH<x>:TRIGger:A:SETHold: DATa:THReshold:REF<x>

EARCH<x>:TRIGger:A:SETHold:

OUrce

Description

Sets or returns the reference waveform threshold LOW level for a runt trigger search to determine w is the search number or the reference waveform number

Sets or returns the condition setting for a runt trigge place a mark. <x> is the search number

Sets or returns the width setting for a runt trigger search to determine where to place a mark. <x> i

Sets or re setup/hold trigger search to determine where to place a mark. <x> is the search number

Sets o r returns the clock source setting for a setup/h to place a mark. <x> is the search number

Sets or returns the clock threshold setting for a setup/hold trigger search to determine where t number or channel number

Sets or returns the clock threshold setting for a setup/hold trigger search to determine where number or math waveform number

Sets or returns the clock threshold setting for a setup/hold trigger search to determine

etoplaceamark. <x>isthesearch

wher number or reference waveform number

Sets or returns the data source setting for a setup/hold trigger search to determine where

place a mark. <x> is the search number

ts or returns the data threshold setting

Se for a setup/hold trigger search to determine where to place a mark. <x> is the search

umber or channel number

ets or returns the data threshold setting

S for a setup/hold trigger search to determine where to place a mark. <x> is the search number or math waveform number

Sets or returns the threshold high voltage level setting for a transition trigger search to determine where to place a mark. <x> is the search number or reference waveform number

here to place a mark.

r search to determine where to

s the search number

turns the clock slope setting for a

old trigger search to determine where

o place a mark. <x> is the search

to place a mark. <x> is the search

<x>

2-50 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

SEARCH:SEARCH<x>:TRIGger:A:SETHold: HOLDTime

SEARCH:SEAR SETTime

SEARCH:SEARCH<x>:TRIGger:A:STATE: CLOCk:EDGE

SEARCH:SEARCH<x>:TRIGger:A:STATE: CLOCk:SOUrce

SEARCH:SEARCH<x>:TRIGger:A:STATE: WHEn

SEARCH:SEARCH<x>:TRIGger:A:TIMEOut: POLarity:CH<x>

SEARCH:SEARCH<x>:TRIGger:A:TIMEOut: POLarity:MATH<x>

SEARCH:SEARCH<x>:TRIGger:A:TIMEOut: POLarity:REF<x>

SEARCH:SEARCH<x>:TRIGger:A:TIMEOut: TIMe

ARCH:SEARCH<x>:TRIGger:A:

SE TRANsition:DELTATime

EARCH:SEARCH<x>:TRIGger:A:

S TRANsition:POLarity:CH<x>

SEARCH:SEARCH<x>:TRIGger:A: TRANsition:POLarity:MATH<x>

CH<x>:TRIGger:A:SETHold:

Description

Sets or returns the hold time setting for a setup/hold trigger search to determine where to place a mark

Sets or retur setup/hold trigger search to determine where to place a mark. <x> is the search number

Sets or returns the clock slope setting for a state trigg place a mark. <x> is the search number

Sets or returns the clock source of the twelve waveforms for a state trigger search to determ the search number. The hardware trigger is always on the channel CH4

Sets or queries the state trigger search to determi the search number

Sets or returns the polarity for a timeout trigger search to determine where to place a mark. < number

Sets or returns the polarity for a timeout trigger search to determine where to place

. <x> is the s earch number or math

amark waveform number

Sets or returns the polarity for a timeout trigger search to determine where to place a

. <x> is the search number or reference

mark waveform number

Sets or returns the time setting for a timeout trigger search to determine where to place a

rk. <x> is the search number

ts or returns the transition time setting

Se for a transition trigger search to determine where to place a mark.<x> is the search

umber

ets or returns the polarity setting for a

S transition trigger search to determine where to place a mark. <x> is the search number or channel number

Sets or returns the polarity setting for a transition trigger search to determine where to place a mark. <x> is the search number or math waveform number

. <x> is the search number

ns the s etup time setting for a

er search to determine where to

inewheretoplaceamark. <x>is

ne where to place a mark.

x> is the search number or channel

<x> is

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-51

Command Groups

Command

SEARCH:SEARCH<x>:TRIGger:A: TRANsition:POLarity:REF<x>

SEARCH:SEARCH<x>:TRIGger:A: TRANsition:THReshold:HIGH:CH<x>

SEARCH:SEARCH<x>:TRIGger:A: TRANsition:THReshold:HIGH:MATH<x>

SEARCH:SEARCH<x>:TRIGger:A: TRANsition:THReshold:HIGH:REF<x>

SEARCH:SEARCH<x>:TRIGger:A:

tion:THReshold:LOW:CH<x>

TRANsi

SEARCH:SEARCH<x>:TRIGger:A:

ition:THReshold:LOW:MATH<x>

TRANs

SEARCH:SEARCH<x>:TRIGger:A:

sition:THReshold:LOW:REF<x>

TRAN

RCH:SEARCH<x>:TRIGger:A:

SEA TRANsition:WHEn

SEARCH:SEARCH<x>:TRIGger:A:TYPe Sets or returns the trigger type setting for a

Description

Sets or returns the polarity setting for a transition trigger search to determine where to place a mark or reference waveform number

Sets or returns the threshold high voltage level setting for a transition trigger search to determine w search number or channel number

Sets or returns the threshold high voltage level setting for a transition trigger search to determine search number or math waveform number

Sets or returns the threshold high voltage level setting for a transition trigger search to determ the search number or reference waveform number

Sets or returns the threshold low voltage

etting for a transition trigger search to

level s determine where to place a mark. <x> is the search number or channel number

Sets or returns the threshold low voltage

setting for a transition trigger search to

level determine where to place a mark. <x> is the search number or math waveform number

Sets or returns the threshold low voltage

l setting for a transition trigger search

leve to determine where to place a mark. <x> is the search number or reference waveform

numb

s or returns the condition setting for a

Set transition trigger search to determine where to place a mark. <x> is the search number

arch to determine where to place a mark.

se <x> is the search number

. <x> is the search number

here to place a m ark. <x> is the

where to place a m ark. <x> is the

inewheretoplaceamark. <x>is

NOTE. Except EDGE all other options must be purchased.

SEARCH:SEARCH<x>:TRIGger:A:WIDth: HIGHLimit

SEARCH:SEARCH<x>:TRIGger:A:WIDth: LOWLimit

Sets or returns the upper time limit setting for a width search to determine where to place a mark. <x> is the search number

Sets or returns the lower time limit setting for a width search to determine where to place a mark. <x> is the search number

2-52 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

SEARCH:SEARCH<x>:TRIGger:A:WIDth: POLarity:CH<x>

SEARCH:SEAR POLarity:MATH<x>

SEARCH:SEA POLarity:REF<x>

SEARCH:S WHEn

SEARCH:SEARCH<x>:TRIGger:A:WINdow: EVENT

SEARCH:SEARCH<x>:TRIGger:A:WINdow: THReshold:HIGH:CH<x>

SEARCH:SEARCH<x>:TRIGger:A:WINdow: THReshold:HIGH:MATH<x>

SEARCH:SEARCH<x>:TRIGger:A:WINdow: THReshold:HIGH:REF<x>

SEARCH:SEARCH<x>:TRIGger:A:WINdow: THReshold:LOW:CH<x>

SEARCH:SEARCH<x>:TRIGger:A:WINdow: THReshold:LOW:MATH<x>

SEARCH:SEARCH<x>:TRIGger:A:WINdow: THReshold:LOW:REF<x>

SEARCH:SEARCH<x>:TRIGger:A:WINdow: WIDth

CH<x>:TRIGger:A:WIDth:

RCH<x>:TRIGger:A:WIDth:

EARCH<x>:TRIGger:A:WIDth:

Description

Sets or returns the polarity for a width search to determine where to place a mark. <x> is the search num

Sets or retur to determine where to place a m ark. <x> is the search number or math waveform number

Sets or retu to determine where to place a mark. <x> is the search number or reference waveform number

Sets or qu wheretoplaceamark. number

Sets or queries the window search to determi the search number

Sets or returns the channel waveform threshold H IGH level for a window search to

ine where to place a mark. <x> is the

determ search number or channel number

Sets or returns the channel waveform threshold H IGH level for a window search to

mine where to place a mark. <x> is the

deter search number or math waveform number

Sets or returns the channel waveform threshold H IGH level for a window search to

rmine where to place a mark. <x> is the

dete search number or reference number

Sets or returns the channel waveform threshold LOW level for a window search to

termine where to place a mark. <x> is the

de search number or channel number

Sets or returns the channel waveform threshold LOW level for a window search to

etermine where to place a mark. <x> is the

d search number or math waveform number

Sets or returns the channel waveform threshold LOW level for a window search to determine where to place a mark. <x> is the search number or reference waveform number

Sets or returns the width setting for a window search to determine where to place a mark. <x> is the search number

ber or channel number

ns the polarity for a width search

rns the polarity for a width search

eries the width search to determine

<x> is the search

ne where to place a mark.

<x> is

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-53

Command Groups

Command

SEARCH:STOP Sets or queries the stop of acquisitions when

SEARCH:SEARCH<x>:TRIGger:A: DDRMemory:M

SEARCH:SEA DDRMemory:MAXCas

SEARCH:SE DDRMemory:MINCas

ARgin

RCH<x>:TRIGger:A:

ARCH<x>:TRIGger:A:

Status and Error Command Group

Use the commands in the Status and Error command Group to determine the status of the instrument and control events.

Several commands and queries used with the instrument are common to all devices on the GPIB bus. The IEEE Std 488.2-1987 deﬁnes these commands and queries. The common commands begin with an asterisk (*) character.

Description

a search ﬁ nds an event

Sets o r queries the termination logic margin for back-to-

Sets or quer clock periods, to the left of the start of the mark where the instrument looks for the chip-selec

Sets or que clock periods, to the left of the start of the mark where the instrument looks for the chip-sel

back writes

ies the maximum distance, in

t pulse

ries the minimum distance, in

ect pulse

iption

Command

*CLS Clears status

*ESE Sets or returns the bits in the Event Status

*ESR? Returns the contents of the Standard Event

*OPT? Returns a list of options installed in the

*PSC Sets or returns the power on status ﬂag

*PUD Sets or returns a string of protected user data

*RST Resets the instrument to factory default

*SRE Sets or returns the bits in the Service

*STB? Returns the contents of the Status Byte

Descr

Enable Register

tus Register

Sta

nerates the operation complete message

Ge in the standard event status register when all pending operations are ﬁnished

returns “1” when all current operations

Or are ﬁnished

instrument

settings

Request Enable Register

2-54 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

*WAI Prevents the instrument from executing

ALLEv?

BUSY?

DESE Sets or retu

EVENT? Returns e vent code from the event queue

EVMsg? Returns event code, message from the event

EVQty? Returns the number of events in the event

TekLink Command Group

Use the commands in the TekLink command Group to set up TekLink and MultiScope triggering.

Command Description

TEKLink:CONNection?

TEKLink:REFClk Sets or queries the current state of the

TRIGger:MULTiscope Sets or returns the state of MultiScope

TRIGger:MULTiscope:ALIGN:COMPleted?

TRIGger:MULTiscope:ALIGN:DESKEW? Sets or returns the deskew time, in

TRIGger:MULTiscope:ALIGN:MRTTime Sends or returns the maximum round trip

TRIGger:MULTiscope:ALIGN:SETSTATE

TRIGger:MULTiscope:ALIGN:VALue? Queries the delay time, in nanoseconds, for

TRIGger:MULTiscope:ALIGN Starts the TekLink trigger alignment

Description

further commands until all pending operations ﬁn

Returns all events and their messages

Returns instrument status

Status Enable Register

queue

Returns the current TekLink network connection

instrument’s TekLink Reference Output

triggering, either ENABle or DISable

Returns whether the oscilloscope has successfully completed the MultiScope trigger align procedure

nanoseconds, for horizontal positioning of the waveform

time to each instrument in a calibration cycle

Measures the round trip time between sending a trigger out the TekLink port and receiving it back from the port

trigger out of the TekLink trigger out line

procedure on all oscilloscopes which are participating with the oscilloscope that is in MultiScope triggering

ish

rns the bits in the Device Event

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-55

Command Groups

Command Description

TRIGger:MULTiscope:DELay? Returns the delay time for trigger out of the

TRIGger:MULTiscope:LOGic Sets or queries the role of the instrument in

TRIGger:MU

TRIGger:MULTiscope:ROLe Sets or returns the role of the instrument

Trigger Command Group

Use the commands in the Trigger Command Group to control all aspects of triggering for the instrument.

There are two triggers: A and B. Where appropriate, the command set has parallel constructions for each trigger.

LTiscope:OPTion

TekLink trigger out line

the MultiSco

Sets or retu TekLink trigger

in the MultiScope trigger network, either PRODUCER o

pe trigger network

rns the trigger type for the

rCONSUMER

You can set the A or B triggers to edge mode. Edge triggering lets you display a waveform at or near the point where the signal pa sses through a voltage level of your choosing.

You can also set A or B triggers to pulse or logic modes. With pulse triggering, the instrument triggers 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 instrument then triggers when it detects a certain combination of signal levels. Video triggering enables you to trigger on the most common Standard Deﬁnition, High Deﬁnition, and custom video standards. You can trigger o n all ﬁelds, all lines, or individual video lines. Video trigger commands are only available on DPO7000 instruments.

If you have Option MTM (Mask Testing) installed, you also have access to a communication mode. When this mode is selected, several communication trigger commands are available that work in conjunction with the mask co

mmands. Refer

to Mask Command Group.

Command

TRIGger

TRIGger:A Sets A trigger level to 50% or returns current

TRIGger:{A|B}:EDGE:COUPling Sets or returns the type of coupling for the

TRIGger:{A|B}:EDGE:SLOpe Sets or returns the slope for the edge trigger

TRIGger:{A|B}:EDGE:SLOpe:AUX Sets or returns the slope for the edge trigger

Description

Forces a trigger event to occur or returns current trigger parameters for the instrument

A trigger parameters

edge trigger

for the AUX In input

2-56 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

TRIGger:{A|B}:EDGE:SLOpe:CH<x> Sets or returns the slope for the edge trigger

TRIGger:{A|B}:EDGE:SOUrce Sets or returns the source for the edge trigger

TRIGger:{A|B}:LEVel Sets or returns the level for the trigger

TRIGger:{A|B}:LEVel:CH<x> Sets or returns the level for the trigger for the

TRIGger:{

TRIGger:

TRIGger:{A|B}:LOGIc:CLAss Sets or returns the type of trigger logic

TRIGger:{A|B}:LOGIc:FUNCtion Sets or returns the logical combination of the

TRIGger:{A|B}:LOGIc:INPut? Returns the logic trigger input expected for

TRIGg

TRIGger:{A|B}:LOGIc:PATtern:INPut:CH<x> Sets or returns the logic pattern trigger input

TRIGger:{A|B}:LOGIc:PATtern:WHEn Sets or returns the condition for generating

TRI LESSLimit

TRIGger:{A|B}:LOGIc:PATtern:WHEn: MO

TRIGger:{A|B}:LOGIc:PATtern? Returns the conditions for generating a logic

TRIGger:{A|B}:LOGIc:SETHold:CLOCk: EDGE

TRIGger:{A|B}:LOGIc:SETHold:CLOCk: SOUrce

TRIGger:{A|B}:LOGIc:SETHold:CLOCk: THReshold

TRIGger:{A|B}:LOGIc:SETHold:CLOCk: THReshold:CH<x>

TRIGger:{A|B}:LOGIc:SETHold:CLOCk?

TRIGger:{A|B}:LOGIc:SETHold:DATa: SOUrce

A|B}:EDGE?

{A|B}:EDGE:COUPling:CH<x>

er:{A|B}:LOGIc:INPut:CH<x>

Gger:{A|B}:LOGIc:PATtern:WHEn:

RELimit

Description

for the channel

channel

bbvannReturns the source, coupling and source for

Sets or qu or B trigger for the speciﬁed channel

input channels for the logic trigger

channe

Sets o trigger channel speciﬁed by x

for the indicated channel

the l

Set the selected pattern may be true and still generate a logic pattern trigger

Sets or returns the minimum time that

e selected pattern may be true and still

th generate a logic pattern trigger

pattern trigger

Sets or returns the clock edge polarity for setup and hold triggering

Sets or returns the clock source for the logic trigger setup and hold input

Sets or returns the clock voltage threshold for setup and hold trigger

Sets or returns the clock voltage threshold for setup and hold trigger for the channel

Returns clock edge polarity, voltage threshold and source input for setup/hold triggering

oh good

Sets or returns the data source for the setup and hold trigger

the edge trigger

eries the type of coupling for the A

l1,2,and3

r queries the logical input for the logic

ogic pattern trigger

s or returns the maximum time that

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-57

Command Groups

Command

TRIGger:{A|B}:LOGIc:SETHold:DATa: THReshold

TRIGger:{A|B}:LOGIc:SETHold:DATa: THReshold:C

TRIGger:{A

TRIGger:{A|B}:LOGIc:SETHold:QUAlify Sets or returns the setup and hold violation

TRIGger:{A|B}:LOGIc:SETHold:SETTime Sets or returns the setup time for setup and

TRIGger

TRIGger:{A|B}:LOGIc:STATE:INPut:CH<x> Sets or returns the slope for indicated channel

TRIGg

TRIGger:{A|B}:LOGIc:STATE? Returns the data input and trigger criteria for

TRIGger:{A|B}:LOGIc:THReshold:CH<x> Sets or returns the logic state trigger

Gger:{A|B}:LOWerthreshold:CH<x>

TRI

TRIGger:{A|B}:LOGIc:THReshold? Returns the threshold voltage for all channels

TRIGger:{A|B}:PULse:CLAss Sets or returns the type of pulse on which

RIGger:{A|B}:PULse:GLItch:POLarity

TRIGger:{A|B}:PULse:GLItch:POLarity: CH<x>

TRIGger:{A|B}:PULse:GLItch:QUAlify Sets or returns the glitch trigger qualiﬁcations

TRIGger:{A|B}:PULse:GLItch:TRIGIF Sets or returns the acceptance or rejection of

TRIGger:{A|B}:PULse:GLItch:WIDth Sets or returns the width of the A pulse glitch

TRIGger:{A|B}:PULse:GLItch?

TRIGger:{A|B}:PULse:RUNT:POLarity Sets or returns the polarity for the pulse runt

H<x>

|B}:LOGIc:SETHold:DATa?

|B}:LOGIc:SETHold:HOLDTime

:{A|B}:LOGIc:SETHold?

er:{A|B}:LOGIc:STATE:WHEn

Description

Sets or returns the data voltage threshold for setup and hold trigger

Sets or returns the data voltage threshold for setup and hol

Returns the voltage threshold and data source for t

Sets or retu and hold violation triggering

trigger qualiﬁcations

hold viol

Returns clock edge polarity, voltage threshold and sour source; and setup/hold times for setup and hold violation triggering

of the l

Sets o logic state trigger

the logic state trigger

shold voltage for the speciﬁed channel

thre

s or returns CH<x> lower trigger level for

Set TRIGger: LVLSrcpreference

in logic trigger

o trigger

ets or returns the polarity for the pulse glitch

S trigger

Sets or returns the polarity for the A or B pulse glitch trigger for the channel

pulse glitch trigger, based on width

trigger

Returns the current A glitch pulse trigger parameters

trigger

d trigger for the channel

he setup/hold trigger

rns the hold time for the setup

ation triggering

ce; data voltage threshold and

ogic state trigger

r returns the condition for generating a

2-58 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

TRIGger:{A|B}:PULse:RUNT:POLarity: CH<x>

TRIGger:{A|B}:PULse:RUNT:QUAlify Sets or returns the polarity for the A or B

TRIGger:{A BOTh

TRIGger:{A|B}:PULse:RUNT:THReshold: HIGH

TRIGger:{A|B}:PULse:RUNT:THReshold: LOW

TRIGger:

TRIGger:{A|B}:PULse:RUNT:WHEn Sets or returns the type of pulse width the

TRIGger:{A|B}:PULse:RUNT:WIDth Sets or returns the minimum width for A pulse

TRIGg

TRIGger:{A|B}:PULse:TIMEOut:POLarity Sets or returns the polarity for the A pulse

TRIGger:{A|B}:PULse:TIMEOut:POLarity: CH<

IGger:{A|B}:PULse:TIMEOut:QUAlify

TRIGger:{A|B}:PULse:TIMEOut:TIMe Sets or returns the pulse timeout trigger time

TRIGger:{A|B}:PULse:TIMEOut? Returns the parameters for the A pulse

TRIGger:{A|B}:PULse:TRANsition: DELTATime

TRIGger:{A|B}:PULse:TRANsition:POLarity Sets or returns the polarity for the A pulse

TRIGger:{A|B}:PULse:TRANsition:POLarity: CH<x>

TRIGger:{A|B}:PULse:TRANsition:QUAlify Sets or returns the transition trigger

TRIGger:{A|B}:PULse:TRANsition: THReshold:BOTh

TRIGger:{A|B}:PULse:TRANsition: THReshold:HIGH

TRIGger:{A|B}:PULse:TRANsition: THReshold:LOW

|B}:PULse:RUNT:THReshold:

{A|B}:PULse:RUNT:THReshold?

er:{A|B}:PULse:RUNT?

er:{A|B}:PULse:SOUrce

Description

Sets or returns the polarity for the A or B pulse runt trigger for the channel

pulse runt tr

Sets the upp for the A pulse runt trigger

Sets or returns the upper limit for the A pulse runt trigger

Sets or returns the lower limit for the A pulse runt trig

Returns t the A pulse runt trigger

trigger checks for when it uncovers a runt

runt tr

Returns the current A r unt pulse trigger param

Sets o trigger

timeout trigger

Sets or returns the polarity for the A or B

se timeout trigger for the channel

pul

ts or returns the timeout trigger

Se qualiﬁcations

timeout trigger

Sets or returns the delta time used in calculating the transition value

transition trigger

Sets or returns the polarity for the A or B pulse transition trigger for the channel

qualiﬁcations

Sets the upper and lower thresholds for the transition trigger

Sets or returns the upper transition trigger threshold

Sets or returns the lower transition trigger threshold

igger

er and lower switching thresholds

ger

he upper and lower thresholds for

igger

eters

r returns the source for the A pulse

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-59

Command Groups

Command

TRIGger:{A|B}:PULse:TRANsition: THReshold?

TRIGger:{A|B}:PULse:TRANsition:WHEn Sets or queries whether to check for a

TRIGger:{A|B}:PULse:TRANsition?

TRIGger:{

TRIGger:{A|B}:PULse:WIDth:LOWLimit S ets or returns the lower limit for the pulse

TRIGger:{A|B}:PULse:WIDth:POLarity Sets or returns the polarity for the pulse width

TRIGger CH<x>

TRIGger:{A|B}:PULse:WIDth:QUAlify Sets or returns the pulse width trigger

TRIGger:{A|B}:PULse:WIDth:WHEn Sets or returns the criteria for width

TRIG

TRI

TRIGger:{A|B}:PULse:WINdow:THReshold: BOTh

TRIGger:{A|B}:PULse:WINdow:THReshold:

IGH

RIGger:{A|B}:PULse:WINdow:THReshold:

T LOW

TRIGger:{A|B}:PULse:WINdow:THReshold? Returns the upper and lower thresholds for

TRIGger:{A|B}:PULse:WINdow:WIDTH Sets or returns minimum width of violation

TRIGger:{A|B}:PULse:WINdow?

TRIGger:{A|B}:PULse?

TRIGger:{A|B}:UPPerthreshold:CH<x> Sets or queries the CH<x> upper trigger level

TRIGger:A:COMMunication: {AMI|HDB3|B3ZS|B6ZS|B8ZS}:PULSEForm

A|B}:PULse:WIDth:HIGHLimit

:{A|B}:PULse:WIDth:POLarity:

ger:{A|B}:PULse:WIDth?

ger:{A|B}:PULse:WINdow:EVENT

Gger:{A|B}:PULse:WINdow:QUAlify

Description

Returns the up for the transition time trigger

transitioni than the speciﬁed delta tim e for the transition time trigger

Returns the delta time, polarity, and both upper and lower threshold l imits for the transition

Sets or ret width trigger

width trigger

trigger

Sets or r pulse width trigger for the channel

qualiﬁcations

ﬁcation of pulse width trigger events

speci

Returns the trigger pulse width parameters

or queries the window trigger event

Sets

s or returns the window trigger

Set qualiﬁcations

Sets both window thresholds

Sets or returns high window threshold

ets or returns low window threshold

the pulse window trigger

Returns the current window pulse trigger parameters

Returns the pulse trigger parameters

for TRIGger:LVLSrcpreference

Sets or returns the selected communication pulse form

per and lower threshold limits

ng signal that is faster or slower

time trigger

urns the upper limit for the A pulse

eturns the polarity for the A or B

2-60 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

TRIGger:A:COMMunication: {AMI|HDB3|B3ZS|B6ZS|B8ZS}:THReshold: HIGH

TRIGger:A:C {AMI|HDB3|B3ZS|B6ZS|B8ZS}:THReshold: LOW

TRIGger:A:COMMunication:BITRate Sets or returns the communication bit rate

TRIGger:A:COMMunication:CLOCk: POLarity

TRIGger: PULSEForm

TRIGger:A:COMMunication:CODe Sets the communication signal code

TRIGger:A:COMMunication:SOUrce Sets the communication source channel

TRIGger:A:COMMunication:SOUrce:TYPe Sets the type of communication source

TRIGger:A:COMMunication:STANdard Selects the communication standard that

TRIGg

TRIGger:A:HOLDoff:BY Sets or returns the type of holdoff for the A

TRIGger:A:HOLDoff:TIMe Sets or returns the A trigger holdoff time

TRIGger:A:HOLDoff? Returns the A trigger holdoff parameters

TRIGger:A:LOGIc? Returns all of the A trigger logic parameters

TRIGger:A:MODe Sets or returns the A trigger mode

TRIGger:A:PULse:WINdow:POLarity Sets or queries the pulse trigger window

TRIGger:A:PULse:WINdow:POLarity: CH<x>

TRIGger:A:TYPe Sets or returns the type of A trigger

TRIGger:A:VIDeo:CUSTom? Returns the custom video parameters for the

TRIGger:A:VIDeo:CUSTom:FORMat Sets or returns the video scan format when

TRIGger:A:VIDeo:CUSTom:LINEPeriod Sets or returns the custom video line period

TRIGger:A:VIDeo:CUSTom:SYNCInterval Sets or returns the custom video sync interval

TRIGger:A:VIDeo:FIELD Sets or returns the video ﬁeld trigger

TRIGger:A:VIDeo:HOLdoff:FIELD Sets or returns the trigger holdoff in video

TRIGger:A:VIDeo:LINE Sets or returns the trigger delay as a number

TRIGger:A:VIDeo:POLarity Sets or returns the polarity of the video trigger

OMMunication:

A:COMMunication:CMI:

er:A:HOLDoff:ACTUal?

Description

Sets the communication threshold high level

Sets the comm

Sets o r returns the polarity of the clock signal

Selects t

channel

iﬁes the code and bit rate

ident

ns the holdoff time actually used by the

Retur A trigger

trigger

olarity of the selected trigger S ource

Sets or queries the pulse trigger window polarity of the speciﬁed channel

A trigger

the video standard is set to Custom

ﬁeld units

of video lines

unication threshold low level

he CMI pulse form

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-61

Command Groups

Command

TRIGger:A:VIDeo:SCAN Sets or returns the video scan rate

TRIGger:A:VIDeo:SOUrce Sets or returns the video trigger source

TRIGger:A:VIDeo:STANdard Sets or returns the video standard

TRIGger:A:VIDeo? Returns the video parameters for the A trigger

TRIGger:AUXLevel Sets or returns the level for the auxiliary

TRIGger:B Sets the B trigger level to 50% or returns the

TRIGger:

TRIGger:B:EVENTS:COUNt Sets or returns the number of events that

TRIGger:B:EVENTS?

TRIGger:B:PULse:WINdow:POLarity Sets or queries the pulse trigger window

TRIGg CH<x>

TRIGger:B:RESET:SOUrce Sets or returns the source for the trigger reset

TRIGger:B:RESET:STATE Sets or returns the state of the B trigger

TRIGger:B:RESET:THReshold Sets or returns the threshold for the trigger

TRIGger:B:RESET:TIMEOut Sets or returns the reset time for the timeout

TRIGger:B:RESET:TYPe Sets or returns the type of A→B sequential

TRIGger:B:TIMe Sets or returns the B trigger delay time

TRIGger:B:STATE Returns the current state of the triggering

TRIGger:B:TYPe Sets or returns the type of B trigger

TRIGger:ENHanced Sets or returns the state of trigger position

TRIGger:LVLSrcpreference Sets or returns how the trigger source and

TRIGger:STATE? Returns the current state of the triggering

TRIGger:SENSITivity Set or returns the state of trigger sensitivity.

B:BY

er:B:PULse:WINdow:POLarity:

RIGger:B:RESET:TRA Nsition

Description

trigger

B trigger

Sets or re qualiﬁers

must occur before the B trigger occurs

Returns the current B trigger events parameter

polar

Sets o polarity of the speciﬁed channel

reset

S for a transition trigger reset

trigger reset

system

enhancement.

levels interact

system

When on, the instrument calculates a rolling average for trigger position enhancement

parameters

turns B trigger time or event

ity of the selected trigger Source

r queries the pulse trigger window

igger reset

ets o r returns the type of transition required

2-62 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Vertical Comm

and Group

Use the commands in the Vertical Command Group to control the vertical setup of all live (channel) waveforms for acquisition and to control the display of channel, reference, a

You may replace VOLts with SCAle in the vertical commands. This provides program com

Command

AUXIn:BANdwidth

AUXIn:CO

AUXIn:OFFSet Sets or returns the vertical offset for the AUX

AUXIn:PRObe:AUTOZero Sets the probe attached to the AUX In input

AUXIn

AUXIn:PRObe:DEGAUSS:STATE?

AUXIn:PRObe:FORCEDRange Sets the probe attached to the AUX In input

AUXIn:PRObe:GAIN? Returns the gain factor of the probe that is

AUXIn:PRObe:ID:SERnumber?

AUXIn:PRObe:ID:TYPe?

AUXIn:PRObe:INPUTMode Sets or returns one of the probe’s four input

UXIn:PRObe:INPUTMode:AOFFSet

AUXIn:PRObe:INPUTMode:BOFFSet Sets or returns the requested B mode offset

AUXIn:PRObe:INPUTMode:CMOFFSet Sets or returns the requested common mode

AUXIn:PRObe:INPUTMode:DMOFFSet Sets or returns the requested differential

AUXIn:PRObe:RANge Sets or queries the set attenuation range of

nd math waveforms.

patibility with earlier models of Tektronix instruments.

UPling

:PRObe:DEGAUSS

Description

Sets or returns the s electable low-pass bandwidt

Sets or re setting for the AUX In input

In input

to auto

Start to the AUX In input

Retur AUX In input has been degaussed

to the default range of the probe, or the comm probe

attached to the AUX In input

Returns the probe serial number

Returns the probe type

S control of the probe that is attached to the AUX In input

control of the probe that is attached to the AUX In input

offset control of the probe that is attached to the AUX In input

mode offset control of the probe that is attached to the AUX In input

the probe on the AUX In input

hlimitﬁlter of the AUX In input

turns the input attenuator coupling

zero

s a degauss cycle of the probe attached

ns whether the probe attached to the

and returns the default range of the

odes

ets or returns the requested A mode offset

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-63

Command Groups

Command

AUXIn:PRObe:RESistance? Returns the resistance factor of the probe

AUXIn:PRObe:SET Sets or queries aspects of probe accessory

AUXIn:PRObe:SIGnal Sets or queries aspects of probe accessory

AUXIn:PRObe:TIPtype Sets or returns the type of probe tip being

AUXIn:PR

AUXIn:PROBEFunc:EXTAtten Sets or returns the input-output ratio, of

AUXIn:PROBEFunc:EXTDBatten Sets or returns the input-output ratio

AUXIn:PROBEFunc:EXTUnits Sets or returns the unit of measurement for

CH<x>? Returns vertical parameters for the speciﬁed

CH&l

CH<x>:BANdwidth:ENHanced Sets or queries either the “Bandwidth

CH<x>:BANdwidth:ENHanced:FORCe Sets or returns the Force constant sample

CH<x>:BANdwidth:ENHanced:STATE? Returns the state of the bandwidth

CH<x>:COUPling Sets or returns the coupling setting for the

CH<x>:DESKew Sets or returns the deskew time for the

CH<x>:LABel:NAMe Deﬁnes or returns the label for the channel

CH<x>:LABel:XPOS Sets or returns the X display coordinate for

Obe:UNIts?

t;x>:BANdwidth

<x>:BANdwidth:ENHanced:APPLYtoall

Description

that is attached to the AUX In input

user interfa attenuation factors

user interfaces

used

Returns a measure for the probe attached to the AUX In input

externa signal and the AUX In input

(expressed in decibel units) of external attenu the instrument AUX In input

the external attenuator of the AUX In input

chan

Sets channel

Enhancement (DSP) Enabled” or “Analog

ly” option.

ts or queries whether the enhanced

Se bandwidth ﬁlter applies to all active channels

rate of the Digital Filters (DSP)

enhancement ﬁlter

Sets or queries the bandwidth enhancement ﬁlter type

speciﬁed channel

waveform

the channel waveform label

ces, for example probe

string describing the units of

l attenuation or gain, between the

ation or gain between the signal and

nel

or returns the bandwidth of the speciﬁed

2-64 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

CH<x>:LABel:YPOS Sets or returns the Y display coordinate for

CH<x>:OFFSet Sets or returns the channel offset

CH<x>:POSition Sets or returns the channel vertical position

CH<x>:PRObe?

CH<x>:PRO

CH<x>:PRObe:DEGAUSS Starts a degauss cycle of the probe attached

CH<x>:PRObe:DEGAUSS:STATE?

CH<x>:PRObe:FORCEDRange Sets the attached probe to its default range,

CH<x>:

CH<x>:PRObe:ID? Returns the type and serial number of

CH<x

CH<x>:PRObe:ID:SERnumber? Returns the serial number of the probe that

CH<x>:PRObe:INPUTMode Sets or queries the input mode of the probe

<x>:PRObe:INPUTMode:AOFFSet

CH<x>:PRObe:INPUTMode:BOFFSet Sets or queries the requested B mode offset

CH<x>:PRObe:INPUTMode:CMOFFSet Sets or queries the requested common mode

CH<x>:PRObe:INPUTMode:DMOFFSet Sets or queries the requested differential

CH<x>:PRObe:RANge Sets or returns the attenuation range of the

CH<x>:PRObe:RESistance? Returns the resistance of the probe that is

be:AUTOZero

PRObe:GAIN?

>:PRObe:ID:TYPe?

Description

the channel waveform label

Returns the gain, resistance, units, and ID of the probe that is attached to the s peciﬁed channel

Autozeros channel

to the speciﬁed channel

Returns whether the probe attached to the speciﬁed channel has been degaussed

or it ret

Return to the speciﬁed channel

the probe that is attached to the speciﬁed chann

Retu the speciﬁed channel

is attached to the speciﬁed channel

tha

Se control of the probe that is attached to the speciﬁed channel

ontrol of the probe that is attached to the

c speciﬁed channel

offset control of the probe that is attached to the speciﬁed channel

mode offset control of the probe that is attached to the speciﬁed channel

probe on the designated channel

attached to the speciﬁed channel

the probe attached to the speciﬁed

urns the default range of the probe

s the gain of the probe that is attached

rns the type of probe that is attached to

t is attached to the speciﬁed channel

ts or queries the requested A mode offset

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-65

Command Groups

Command

CH<x>:PRObe:SET Sets or queries aspects of probe accessory

CH<x>:PRObe

CH<x>:PRObe:TIPtype Sets or returns the type of probe tip being

CH<x>:PRObe:UNIts? Returns the units of the probe that is attached

CH<x>:PR

CH<x>:P

CH<x>:PROBEFunc:EXTDBatten Sets the attenuation value for the speciﬁed

CH<x>:PROBEFunc:EXTUnits Sets the unit of measurement for the external

CH<x>:SCAle Sets or returns the vertical scale of the

x>:TERmination

CH<

F<x>:HORizontal:POSition

EF<x>:LABel?

EF<x>:LABel:NAMe

REF<x>:LABel:XPOS Sets or returns the position of the reference

REF<x>:LABel:YPOS Sets or returns the position of the reference

REF<x>:VERTical:POSition Sets or returns the vertical position of the

REF<x>:VERTical:SCAle Sets or returns the reference waveform

SELect? Returns information on which waveforms are

:SIGnal

OBECal?

OBECOntrol

ROBEFunc:EXTAtten

Description

user interfaces, for example probe attenuation f

Sets or queri user interfaces

used on the speciﬁed channel

to the spec

Returns the probe calibration status

Sets or qu

Sets the channel to the speciﬁed scale factor

Or returns the user-speciﬁed attenuation

channe

Or returns the user-speciﬁed attenuation, in decibels

atten

Or returns the user-speciﬁed unit of measurement for the external attenuator

ciﬁed channel

spe

s channel input termination

Set

ts or returns the horizontal position of the

Se speciﬁed reference waveform in percent of the waveform that is displayed to the right of

e center vertical graticule

Returns a branch query containing the

aveform l abel name and the coordinates at

w which the label is displayed

Sets or returns the label of the designated waveform

waveform label on the X axis

waveform label on the Y axis

speciﬁed reference waveform

vertical scale in vertical units/div

on or off and which waveform is selected

actors

es aspects of probe accessory

iﬁed channel

eries the probe range

attenuation value for the speciﬁed

l to the speciﬁed value, in decibels

uator of the speciﬁed channel

2-66 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

SELect:<wfm> Turns on the speciﬁed waveform

SELect:CH<x

SELect:CONTROl Sets or returns the waveform controlled by

Waveform Transfer Command Group

Use the co waveform data points to and from the instrument. Waveform data points are a collection of values that deﬁne a waveform. One data value usually represents one data point in the waveform record. When working with envelope waveforms, each data value is either the minimum or maximum of a min/max pair.

Before you transfer waveform data, you must specify the data format, record length, and waveform source.

Data F

data point. The number of bits used depends on the acquisition mode speciﬁed when you acquired the data. Data acquired in SAMple or ENVelope mode uses eight bits per waveform data point. Data acquired in AVERage mode uses up to 14 bits per point.

mmands in the Waveform Transfer Command Group to transfer

ormats. Acquired waveform data uses eight or more bits to represent each

Description

Or returns whether the speciﬁed channel is on or off

Sets or queri speciﬁed channel waveform

the front panel

es the displayed state of the

The instrument can transfer waveform data in either ASCII or binary format. You specify the format with the DATa:ENCdg command. The instrument uses signed, 4 byte integers and ﬂoating point values; it does not support unsigned

ating point values.

ﬂo

ASCII data is represented by signed integer or ﬂoating point values. An example

SCII waveform data string may look like this:

CURVE<space>-110,-109,-110,-110,-109,-107,

-109,-107,-106,-105,-103,-100,-97,-90,-84,-80

Use ASCII to obtain more readable and easier to format output than binary. However, ASCII may require more bytes to send the same values than it does with binary. This may reduce transmission speeds.

Binary data can be represented by signed integer or ﬂoating point values. The range of the values depends on the byte width speciﬁed. When the byte width is one, signed integer data ranges from -128 to 127, and positive integer values range from 0 to 255. When the byte width is two, the values range from -32768 to

32767. When a MATH (or REF that came from a MATH) is used, 32 bit ﬂoating point values are used that are four bytes in width.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-67

Command Groups

The deﬁned bina The following are the four binary formats:

RIBinary spec signiﬁcant byte transferred ﬁrst.

SRIBinary i meaning that the least signiﬁcant byte is transferred ﬁrst. This format is useful when transferring data to PCs.

RFBinary speciﬁes ﬂoating point data-point representation with the most signiﬁcant byte transferred ﬁrst.

SRFBinary is the same as RFBinary except that the byte order is swapped, meaning that the least signiﬁcant byte is transferred ﬁrst. This format is useful when transferring data to PCs.

Waveform Data and Record Lengths. You can transfer multiple points for each wavefo the entire record. You can use the DATa:STARt and DATa:STOP commands to specify the ﬁrst and last data points of the waveform record.

When transferring data into the instrument, you must ﬁrst specify the record length of the destination waveform record. You do this with the WFMInpre:NR_Pt command. Next, specify the ﬁrst data point within the waveform record. For example, when you set DATa:STARt to 1, data points will be stored starting with the ﬁrst point in the record. The instrument will ignore the value set by DAT data to read or when it has reached the speciﬁed record length.

rm record. You can transfer a portion of the waveform or you can transfer

a:STOP when reading in data. It will stop reading data when there is no more

ry formats specify the order in which the bytes are transferred.

iﬁes signed integer data-point representation with the most

s the same as RIBinary except that the byte order is swapped,

en transferring data from the instrument, you must specify the ﬁrst and last

Wh data points in the waveform record. Setting DATa:STARt to 1 and DATa:STOP to the record length will always return the entire waveform.

Waveform Data Locations and Memory Allocation. The DATa:SOUrce command speciﬁes the waveform source when transferring a waveform from the instrument. Waveforms sent to the instrument are always stored in one of the four reference memory locations. Use the DATa:DESTination command to specify a reference memory location.

Waveform Preamble. Each waveform that you transfer has an associated waveform preamble that contains information such as the horizontal scale, the vertical scale, and other settings in effect when the waveform was created. Refer to the individual WFMInpre and WFMOutpre commands for more information.

Scaling Waveform Data. 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.

2-68 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Transferring W

aveform Data from the Instrument.

You can transfer waveforms from the instrument to an external controller using the following sequence:

1. Select the waveform source(s) using DATa:SOUrce.

2. Specify the waveform data format using DATa:ENCdg.

3. Specify the number of bytes per data point using WFMOutpre:BYT_Nr.

NOTE. MATHwaveforms(andREFwaveformsthatcamefromaMATH)are

always set to four bytes.

4. Specify the portion of the waveform that you want to transfer using DATa:STA Rt and DATa:STOP.

5. Transfer waveform preamble information us

ing WFMOutpre.

6. Transfer waveform data from the instrument using CURVe.

Transferring Waveform Data to the Instrument.

1. Specify waveform reference memory using DATa:DESTination.

2. Set WFMInpre:NR_Pt to equal the number of data points to be sent.

3. Specify the waveform data format using WFMInpre:ENCdg.

4. Specify the number of bytes per data point using WFMInpre:BYT_Nr.

5. Specify ﬁrst data point in the waveform record using DATa:STARt.

6. Transfer waveform preamble information using WFMInpre.

7. Transfer the waveform data using CURVe.

NOTE. FastAcq waveforms cannot be returned to the instrument via the CURVe

command.

Command

ALLOcate:WAVEform:REF<x>? Returns the record length for the speciﬁed

CURVe The command format transfers waveform

Description

reference waveform, if active, or zero (0) if not active

data to the instrument (reference memory location speciﬁ ed by DATa:DESTination)

The query format transfers waveform data from instrument speciﬁed by the DATa:SOUrce command

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-69

Command Groups

Command

CURVENext? Returns unique waveform data from a new

CURVEStream Transfers continuously the waveform data

DATa

DATa:DESTination Sets or returns the reference memory

DATa:ENCdg Sets or returns the format of outgoing

DATa:FRAMESTARt Sets or queries the starting data frame for

RAMESTOP

DATa:F

DATa:SOUrce Sets or returns the location of waveform data

DATa:STARt Sets or returns the starting point in waveform

:STOP

DATa

WAVFrm? Returns WFMOutpre? and CURVe? data

VFRMStream?

WFMInpre? Returns the waveform formatting

WFMInpre:BIT_Nr

WFMInpre:BN_Fmt

WFMInpre:BYT_Nr

WFMInpre:BYT_Or Sets or returns the byte order of waveform

WFMInpre:ENCdg Sets or returns the type of encoding for

Description

acquisition

from the inst

Sets the for data that is transferred with the CURVe Command

Or returns t waveform data that is transferred with the CURVe? command

location the instrument

waveform data

wavefo

Sets or waveform transfer

transferred from the instrument

sfer

tran

Sets waveform transfer

for the waveform as speciﬁed by the

TA:SOUrce command

turns WFMOUTPRE ? and

Re CURVESTREAM? data for the waveforms speciﬁed by the DATASOURCE command

peciﬁcation to be applied to the next

s incoming CURVE command data

Sets or returns the number of bits per binary waveform point

Sets or returns the format of binary data for the incoming waveform

Sets o r returns the binary ﬁeld data width for the ﬁrst ordered waveform

points

incoming waveform data

rument as it is acquired

mat and location of the waveform

he format and location of the

for storing waveform data sent to

rm transfer

queries the ending data frame for

or returns the ending data point in

2-70 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

WFMInpre:NR_

WFMInpre:PT_Fmt

WFMInpre:P

WFMInpre:W

WFMInpre:XINcr

WFMInpre:XUNit

WFMInpr

WFMInp

pre:YOFf

WFMIn

npre:YUNit

WFMI

WFMInpre:YZEro

MOutpre?

WFMOutpre:BIT_Nr Sets or returns the number of bits per

WFMOutpre:BN_Fmt Sets or returns the format of binary data for

WFMOutpre:BYT_Nr Sets or returns the data width for the

WFMOutpre:BYT_Or Sets or returns the byte order of waveform

WFMOutpre:ENCdg Sets or returns the type of encoding for

WFMOutpre:NR_Pt? Returns the number of points for the

WFMOutpre:PT_Fmt? Returns the point format for the waveform

T_Off

FId

e:XZEro

re:YMUlt

Description

Sets or returns the number of points in the transmitted waveform record

Sets or returns the point format of incoming waveform dat

Sets or retu incoming waveform data

Allows a waveform extracted from the instrument to be more easily sent back

Sets or returns the horizontal sampling interval

Sets or re incoming waveform

Sets or returns the (sub-sample) time between the trigger sample and the occurre trigger

Sets or returns the vertical scale factor, per digitizing level, of the incoming waveform

point

Sets o incoming waveform in digitizing levels

Sets or returns the vertical units of the incoming waveform

Sets or returns the offset of the incoming

eform

wav

turns the waveform formatting data for the

Re waveform speciﬁed by the DATA:SOURCE command

aveform point that outgoing waveforms

w contain

the waveform

waveform

points

outgoing waveforms

waveform transmitted in response to a CURVe? query

rns the trigger point within the

between incoming waveform points

turns the horizontal units of the

nce of the actual incoming waveform

r returns the vertical position of the

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-71

Command Groups

Command

WFMOutpre:PT_Off?

WFMOutpre:PT_ORder? Returns whether the source waveform is

WFMOutpre:WFId?

WFMOutpre:XINcr?

WFMOutpre:XUNit? Returns the horizontal units for the waveform

WFMOutpre:XZEro? Returns the (sub-sample) time between the

WFMOutpre:YMUlt? Returns the vertical scale factor per digitizing

WFMOutpre:YOFf? Returns the vertical offset in digitizing levels

WFMOut

WFMOu

WFMInpre:NR_FR

WFMOutpre:NR_FR? Query-only command returns the number

pre:YUNit?

tpre:YZEro?

Description

Returns the tr DATA:START for the waveform

DPO

Returns a string describing the acquisition parameters for the waveform

Returns the horizontal sampling interval

trigger s actual waveform trigger

level for the waveform

for the w

Return

ns the vertical offset for the waveform

Retur

Sets o the number of frames in the transmitted waveform record

ames for the DATa:SOUrce waveform

of fr transmitted in response to a CURVe?query

igger point relative to

ample and the occurrence of the

aveform

s the vertical units for the waveform

r returns one frame, indicating

Zoom Command Group

Zoom commands let you expand and position the waveform display horizontally and vertically, without changing the time base or vertical settings.

Youcanspecifyuptofourzoomareas. Youcanalsospecifyazoomedwaveform as a zoom source, which enables you to zoom in on a zoomed waveform.

Command

ZOOm Resets the zoom transforms to default values

ZOOm:GRAticule:SIZE Sets or returns the size of the zoom graticule

ZOOm:HORizontal:POSition Sets or queries the horizontal position around

Description

for all traces or live traces. Th returns the current vertical and horizontal positioning and scaling of the display

which the zoom waveform is dis It is freely movable within the conﬁnes of the acquired waveform (0% to 100%) and measured from left to right o waveform

e ZOOm query

played.

f the acquired

2-72 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Command Groups

Command

ZOOm:HORizontal:SCAle Sets or queries the zoom horizontal scale

ZOOm:MATH<x

ZOOm:MATH<x>:HORizontal:SCAle Sets or queries the zoom horizontal scale

ZOOm:MATH<x>:VERTical:POSition Sets or queries the vertical position of the

ZOOm:MAT

ZOOm:MODe Sets or returns the zoom mode

ZOOm:REF<x>:HORizontal:POSition Sets or queries the horizontal position of the

ZOOm:REF<x>:HORizontal:SCAle Sets or queries the zoom horizontal scale

REF<x>:VERTical:POSition

ZOOm:

ZOOm:REF<x>:VERTical:SCAle Sets or queries the zoom vertical scale of the

ZOOm:SCROLL:DIREction Sets or returns the direction of AutoScroll for

m:SCROLL:LOCk

ZOO

ZOOm:SCROLL:SPEED Sets or returns the speed of AutoScroll for

ZOOm:STATE Speciﬁes or returns a trace as zoomed, on

OOm:VERTical:POSition

ZOOm:VERTical:SCAle Sets or queries the zoom vertical scale

ZOOm:ZOOM<x> Sets or returns zoom factors for the speciﬁed

ZOOm:ZOOM<x>:<wfm>:HORizontal: POSition

ZOOm:ZOOM<x>:<wfm>:HORizontal:SCAle Sets or returns the horizontal zoom scale of

>:HORizontal:POSition

H<x>:VERTical:SCAle

Description

factor around which the zoom waveform is displayed

Sets o r queri speciﬁed math waveform

factor of the speciﬁed math waveform

speciﬁed m

Sets or qu speciﬁed math waveform

speciﬁed reference w aveform

factor

Sets o speciﬁed reference w aveform

speciﬁed reference w aveform

zoom

s or returns the state of Scroll Lock, on

Set or off

zoomed waveforms

roff

ets or queries the vertical position around

S which the zoom waveform is displayed. It is freely movable within the conﬁnes of the acquired waveform ( 0% to 100%) and measured from left to right of the acquired waveform

factor around which the zoom waveform is displayed

zoom

Sets or returns the horizontal zoom position for the speciﬁed waveform in the speciﬁed zoom

the speciﬁed waveform in the speciﬁed zoom

es the horizontal position of the

ath waveform

eries the vertical scale of the

of the speciﬁed reference waveform

r queries the vertical position of the

ed waveforms

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-73

Command Groups

Command

ZOOm:ZOOM<x>:<wfm>:HORizontal: TIMEPosition

ZOOm:ZOOM<x POSition

ZOOm:ZOOM<x>:<wfm>:VERTical:SCAle Sets or returns the vertical zoom scale for

ZOOm:ZOOM<x>:SCROLLLock Sets or returns Scroll Lock for the speciﬁed

ZOOm:ZOO

ZOOm:ZOOM<x>:STATE Sets or queries the speciﬁed zoom on or off,

>:<wfm>:VERTical:

M<x>:<wfm>:DISplay

Description

Sets or queries the zoom horizontal position of the s peciﬁed waveform for the speciﬁed zoom in time

Sets o r retur the speciﬁed waveform in the speciﬁed zoom

the speciﬁed waveform in the speciﬁed zoom

zoom

Sets or re waveform for the speciﬁed zoom

where x is an integer from 1 to 4 representing the desi

ns the vertical zoom position for

turns the display of the speciﬁed

red zoom window

2-74 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Commands Listed in Alphabetical Order

ACQuire? (Query Only)

This query-only command returns the following current acquisition parameters:

Stop after

Acquisition state

Mode

Number of envelopes

Number of averages

Number of samples

Sampling mode

Group

Syntax

Related Commands

Examples

Acquisition

ACQuire?

ACQuire:MODe, ACQuire:NUMFRAMESACQuired?, ACQuire:NUMAVg, ACQuire:NUMEnv, ACQuire:STOPAfter

ACQUIRE? might return the following string for the current acquisition parameters:

:ACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE;NUMENV 10;NUMAVG 16;NUMSAMPLES 16000;SA MPLINGMODE IT

ACQuire:INTERPEightbit

This command sets or queries the interpolation acquisition mode of the instrument.

Group

Syntax

Acquisition

ACQuire:INTERPEightbit {AUTO|ON|OFF} ACQuire:INTERPEightbit?

Arguments

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-75

AUTO lets the instrument automatically select the interpolation acquisition mode.

ON turns on the eight bit interpolation mode.

Commands Listed in Alphabetical Order

Examples

ACQuire:MODe

OFF turns off th

e eight bit interpolation mode.

Trial

ACQUIRE:INTERPEIGHTBIT ON sets the interpolation sampling mode ON.

ACQUIRE:INTERPEIGHTBIT? might return :ACQUIRE:INTERPEIGHTBIT

indicating the interpolation sampling mode is set to AUTO.

AUTO

This command sets or queries the ac

quisition mode of the instrument. This affects all live waveforms. This command is equivalent to selecting Horizontal/Acquisition from the Horiz/Acq menu, and then choosing the desired mode from the Acquisition Mode group box.

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 instrument 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 ﬁnal value of the acquisition interval is generated from the many data samples.

Group

Syntax

Related Commands

Arguments

Acquisition

ACQuire:MODe {SAMple|PEAKdetect|HIRes|AVErage|WFMDB|ENVelope} ACQuire:MODe?

ACQuire:NUMAVg, CURVe

SAMple speciﬁes that the displayed data point value is the ﬁrst sampled value

that is 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.

PEAKdetect speciﬁes the display of high-low range of the samples taken from a

SAMple is the default mode.

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.

HIRes speciﬁes Hi Res mode where the displayed data point value is the

PEAKdetect mode can reveal the presence of aliasing or narrow spikes.

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

2-76 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Commands Listed in Alphabetical Order

number of sampl

es taken during the acquisition interval determines the number of

data values that compose the average.

AVErage speci

average of

ﬁes averaging mode, in which the resulting waveform shows an

SAMple data points from several separate waveform acquisitions. The

instrument processes the number of waveforms you specify into the acquired waveform, creating a running exponential average of the input signal. The number of waveform acquisitions that go into making up the average waveform is set or queried using the ACQuire:NUMAVg command.

ENVelope speciﬁes envelope mode, where the resulting waveform shows the PEAKdetect range of data points from several separate waveform acquisitions.

The numbe

r of waveform acquisitions that go into making up the envelope

waveform is set or queried using the ACQuire:NUMENv command.

WFMDB (W

aveform Database) mode acquires and displays a waveform pixmap. A

pixmap is the accumulation of one or more acquisitions.

The ins

trument acquires data after each trigger event using Sample mode; it then determines the pix map location of each sample point and accumulates it with stored data from previous acquisitions.

A Pix map is a two dimensional array. The value at each point in the array is a counter that reﬂects the hit intensity. Inﬁnite and noninﬁnite persist display modes affect how pix maps are accumulated. Zoom, Math, FastAcq, FastFrame, XY, Roll, and Interpolated Time (IT) Sampling Mode are conﬂicting features to WFMDB acqMode. Turning on one of them generally turns the other one off.

ection of some standard masks (for example, eye masks, which require option

Sel MTM) changes the acquisition mode to WFMDB.

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 :ACQuire:MODe AVERAGE, indicating that

the displayed waveform is the average of the speciﬁed number of waveform acquisitions.

ACQuire:NUMACq? (Query Only)

This query-only command returns the number of waveform acquisitions that have occurred since starting acquisition with the ACQuire:STATE RUN command. This value is reset to zero when any acquisition, horizontal, or vertical arguments that affect the waveform are changed. The maximum number of acquisitions that can be counted is 2 reached. This is the same value that displays in the lower right of the screen.

Group

Acquisition

–1. The instrument stops counti

ng when this number is

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-77

Commands Listed in Alphabetical Order

Syntax

Related Commands

Examples

ACQuire:NUMAVg

Group

ACQuire:NUMAC

ACQuire:STATE

ACQUIRE:NUMACQ? might return :ACQUIRE:NUMACQ 350, indicating that 350

acquisitions have occurred since executing an ACQuire:STATE RUN command.

This command sets or queries the number of waveform acquisitions that make up an averaged waveform. Use the ACQuire:MODe command to enable the Average mode. Sending this command is equivalent to selecting Horizontal/Acquisition Setup from the Horiz/Acq menu, selecting the Acquisition tab, and choosing Average from the Acquisition Mode group box. Then enter the desired number of waveforms that will be used to make up an averaged waveform in the # of Wfms box.

Acquisition

Syntax

Related Commands

Arguments

Examples

ACQuire:NUMEnv

ACQuire:NUMAVg <NR1> ACQuire:NUMAVg?

ACQuire:MODe

NR1 is the number of waveform acquisitions to average.

ACQUIRE:NUMAVG 10 speciﬁes that 10 waveform averages will be performed

before exponential averaging starts.

ACQUIRE:NUMAVG? might return :ACQUIRE:NUMAVG 75, indicating that t here

are 75 acquisitions speciﬁed for averaging.

This command sets or queries the number of waveform acquisitions that make up an envelope waveform. Sending this command is equivalent to s etting the # of Wfms in the Acquisition Setup menu when Envelope Acquisition mode is selected.

2-78 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Commands Listed in Alphabetical Order

Group

Syntax

Arguments

Examples

NOTE. Sending I

will be 2e9 not INFInite.

Acquisition

ACQuire:NUMEnv {<NR1>|INFInite} ACQuire:NUMEnv?

NR1 is the number of waveform acquisitions to be enveloped.

INFInite

ACQUIRE:NUMENV 10 speciﬁes that an enveloped waveform will show the result

of combining 10 separately acquired waveforms.

ACQUIRE:NUMENV? might return :ACQUIRE:NUMENV 75, indicating that 75

acquisitions are acquired for enveloped waveforms.

NFInite as an argument sets 2e9 envelopes. The query response

ACQuire:NUMFRAMESACQuired? (Query Only)

This query-only command returns the number of frames acquired when in FastFrame Single Sequence and acquisitions are running. When the FastFrame single sequence stop condition is set to Stop Manually, this number counts past the number of frames which were reques ted as new frames are acquired, until STOP is pushed. When not in FastFrame Single Sequence, this value is the same number reported by ACQ:NUMACQ.

Group

Syntax

Related Commands

Examples

Acquisition

ACQuire:NUMFRAMESACQuired?

ACQuire:NUMACq?

ACQUIRE:NUMFRAMESACQUIRED? might return :ACQUIRE:NUMFRAMESACQUIRED 350, indicating that 350 frames have been

acquired.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-79

Commands Listed in Alphabetical Order

ACQuire:NUMS

Arguments

AMples

Group

Syntax

This command sets or queries the minimum number of acquired samples that makeupawaveformdatabase(WfmDB)waveformforsinglesequencemodeand Mask Pass/Fa Database Samples in the Acquisition Mode side menu.

Acquisition

ACQuire:NUMSAMples {<NR1>} ACQuire:NUMSAMples?

NR1 is the minimum number of acquired sa

database (WfmDB) waveform for single sequence mode and Mask Pass/Fail Completion Test. The default value is 16,000 samples. The range is 5,000 to 2,147,400,000 samples.

In real time mode, if the entire trace is displayed, one triggered acquisition should acquire 5000 samples for a record length of 5000. If you want 5001 samples, the instrument will need to make two acquisitions (10,000 samples). If you request fewer samples than the record length, the number o f samples will be the same as the record length.

il Completion Test. This is equivalent to setting the Waveform

mples that make up a waveform

Examples

ACQUIRE:NUMSAMPLES 5000 speciﬁes that 5000 samples will be acquired in

WfmDB mode for single sequence mode and Mask Pass/Fail Completion Test.

ACQUIRE:NUMSAMPLES? might return :ACQUIRE:NUMSAMples 10000,

indicating that there are 10,000 samples to be acquired in WfmDB mode for single sequence and Mask Pass/Fail Completion Test.

ACQuire:SAMPlingmode

This command sets or queries the sampling mode.

Group

Syntax

Arguments

Acquisition

ACQuire:SAMPlingmode {RT|IT|ET} ACQuire:SAMPlingmode?

RT sets the sampling mode to real time only.

IT sets the sampling mode to interpolation allowed (OFF in REPET).

2-80 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Commands Listed in Alphabetical Order

Examples

ACQuire:STATE

ET sets the samp

ling mode to equivalent time allowed (ON in REPET).

The number of channels selected and the sampling speed affects the mode that the instrumen

t uses to acquire data. At slow sampling speeds the instrument uses real time sampling. At fast sampling speeds, the instrument uses equivalent time sampling or interpolation. For speeds between these extremes, some instruments create waveform records differently, depending on the number of input channels selected.

ACQUIRE:SAMPLINGMODE IT speciﬁes that interpolation is allowed.

ACQUIRE:SAMPLINGMODE? might return:ACQUIRE:SAMPLINGMODE RT,

indicating that sampling mode is real time only.

This command starts or stops acquisitions. When state is set to ON or RUN, a new acquisition will be started. If the last acquisition was a single acquisition sequence, a new single sequence acquisition will be started. If the last acquisition was continuous, a new continuous acquisition will be started.

If RUN is issued in the middle of completing a single sequence acquisition (for example, averaging or enveloping), the acquisition sequence is restarted, and any accumulated data is discarded. Also, the instrument resets the number of acquisitions. If the RUN argument is issued while in continuous mode, a reset occurs and acquired data continues to acquire.

Group

Syntax

Related Commands

Arguments

If acquire:stopafter is SEQUENCE, pressing the front panel RUN/STOP button is equivalent to sending these commands: either

ACQUIRE:STATE ON or ACQUIRE:STATE RUN.

ACQUIRE:STOPAFTER RUNSTOP and

Acquisition

ACQuire:STATE {OFF|ON|RUN|STOP|<NR1>} ACQuire:STATE?

ACQuire:STOPAfter

OFF stops acquisitions.

STOP stops acquisitions.

ON starts acquisitions.

RUN starts acquisitions.

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-81

Commands Listed in Alphabetical Order

Examples

ACQuire:STOPAfter

Group

Syntax

NR1=0 stops acq

ACQUIRE:STATE RUN starts the acquisition of waveform data and resets the count

of the number

ACQUIRE:S

acquisition is stopped.

This command sets or queries whether the instrument continually acquires acquisitions or acquires a single s equence. Pressing SINGLE on the front panel button is equivalent to sending these commands:

SEQUENCE

Acquisition

ACQuire:STOPAfter {RUNSTop|SEQuence} ACQuire:STOPAfter?

uisitions; any other value starts acquisitions.

of acquisitions.

TATE?

and ACQUIRE:STATE 1.

might return :ACQUIRE:STATE 0, indicating that the

ACQUIRE:STOPAFTER

ALIas

Related Commands

Arguments

Examples

Group

Syntax

ACQuire:STATE

RUNSTop speciﬁes that the instrument will continually acquire data, if

ACQuire:STATE is turned on.

SEQuence speciﬁes that the next acquisition will be a single-sequence acquisition.

ACQUIRE:STOPAFTER RUNSTOP sets the instrument to continually acquire data.

ACQUIRE:STOPAFTER? might return:ACQUIRE:STOPAFTER SEQUENCE,

indicating that the next acquisition the instrument makes will be of the single-sequence type.

This command sets or queries the state of alias functionality.

Alias

ALIas {OFF|ON|<NR1>} ALIas?

2-82 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Commands Listed in Alphabetical Order

Related Commands

Arguments

Examples

ALIas:STATE

OFF turns Alias expansion off. If a deﬁned alias is sent when ALIas:STATE is off,

a command error (102) will be generated.

ON turns Alias expansion on. When a deﬁned alias is received, the speciﬁed

command sequence is substituted for the alias and executed.

NR1=0 disables Alias mode; any other value enables Alias mode.

ALIAS ON turns the alias feature on. When a deﬁned alias is received, the speciﬁed

command sequence is substituted

ALIAS? might return :ALIAS:STATE 1, indicating that the alias feature is on.

ALIas:CATalog? (Query Only)

This query-only command returns a list of the currently deﬁned a lias labels, separated by commas. If no aliases are deﬁned, the query returns the string “”.

for the alias and executed.

ALIas:DEFine

Group

Syntax

Examples

Alias

ALIas:CATalog?

ALIAS:CATALOG? might return the string :ALIAS:CATALOG "SETUP1","TESTMENU1","DEFAULT"

named SETUP1, TESTMENU1, and DEFAULT.

This command 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, provided that ALIas:STATE has been turned on. The query form of this command returns the deﬁnitions of a selected alias.

NOTE. Attempting to g ive two aliases the same name causes an error. To give a

new alias the name of a n existing alias, the existing alias m ust ﬁrst be deleted.

showing that there are three aliases

Group

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-83

Alias

Commands Listed in Alphabetical Order

Syntax

Related Commands

Arguments

Examples

ALIas:DEFine < ALIas:DEFine?

ALIas:STATE

The ﬁrst <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 less than or equal to 12 characters.

The second

The mess ages can contain only valid commands that must be sepa rated by semicolons and must follow all rules for concatenating comm must be less than or equal to 256 characters.

ALIAS:DEFINE "ST1",":RECALL:SETUP 5;:AUTOSET EXECUTE;:SELECT:CH1 ON"

up the instrument.

ALIAS:DEFINE? "ST1" returns :ALIAS:DEFINE "ST1",#246 :RECALL:SETUP 5;:AUTOSET EXECUT E;:SELECT:CH1 ON

<QString> or <Block> is a complete sequence of prog

QString><,>{<QString>|<Block>}

ram messages.

ands. The sequence

deﬁnes an alias named “ST1” that sets

ALIas:DELEte (No Query Form)

This command remove s a speciﬁed alias and is identical to ALIas:DELEte:NAMe. An error message is generated if the named alias does not exist.

Group

Syntax

Related Commands

Arguments

Examples

Alias

ALIas:DELEte <QString>

*ESR?, ALIas:DELEte:ALL

<QString> is the name of the alias to be removed. Using ALIas:DELEte

without specifying an alias causes an execution error. <QString> must be a previously deﬁned value.

ALIAS:DELETE "SETUP1" deletes the alias named SETUP1.

2-84 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Commands Listed in Alphabetical Order

ALIas:DELEte

Related Commands

:ALL (No Query Form)

This command deletes all existing aliases.

Group

Syntax

Examples

Alias

ALIas:DELEte:ALL

ALIas:DELEte, ALIas:DELEte:NAMe

ALIAS:DELETE:ALL deletes all existing aliases.

ALIas:DELEte:NAMe (No Query Form)

This command removes a s peciﬁed alias. An error message is generated if the named alias does not exist. This command is identical to ALIas:DELEte.

Group

Alias

ALIas:STATE

Syntax

Arguments

Examples

Group

Syntax

ALIas:DELEte:NAMe <QString>

<QString> is the name of the alias to remove. Using ALIas:DELEte:NAMe

without specifying an alias causes an exception error. <QString> must be a previously deﬁned alias.

ALIAS:DELETE:NAME "STARTUP" deletes the alias named STARTUP.

This command turns aliases on or off and is identical to the ALIas command. The query form of this command returns the state of the aliases.

Alias

ALIas:STATE {OFF|ON|<NR1>} ALIas:STATE?

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-85

Commands Listed in Alphabetical Order

Arguments

Examples

ALLEv? (Query Only)

Group

OFF turns alias OFF, the instrument generates a command error (102).

ON turns alias

command sequence is s ubstituted for the a lias and executed.

<NR1>=0 tur

ALIAS:STATE OFF turns off the alias feature.

ALIAS:STATE? might return :ALIAS:STATE ON, indicating that alias expansion

is currently turned on.

This query-only command prompts the instrument to return all events and their messages (delimited by commas), and removes the returned events from the Event Queue. Use the *ESR? query to enable the events to be returned. This command is similar to repeatedly sending *EVMsg? queries to the instrument.

Status and Error

expansion off. If a deﬁnedaliasissentwhen

expansion on. When a deﬁnedaliasisreceived,thespeciﬁed

ns off aliases; any other value turns on aliases.

ALIas:STATE is

Syntax

Related Commands

Examples

ALLEv?

*ESR?, EVMsg?

ALLEV? might return :ALLE V 2225,"Measurement error, No waveform to measure; "420,"Query UNTERMINATED;"

ALLOcate:WAVEform:REF<x>? (Query Only)

This query-only command returns the record length for the speciﬁed reference waveform, if active, or zero (0) if not active (that is, no slot exists for the reference waveform).

Group

Syntax

Waveform Transfer

ALLOcate:WAVEform:REF<x>?

2-86 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Commands Listed in Alphabetical Order

Examples

ALLOCATE:WAVE

active in the reference 3 slot.

AUTOSet (No Query Form)

This command (no query format) sets the vertical, horizontal, and trigger controls of the instrument to automatically acquire and display the selected waveform. (To autoset a video waveform, the video trigger must be set to video standard, not custom pressing the front panel AUTOSET button. For a detailed description of autoset functionality, see Autoset in the index of the online help for your instrument.

Group

Syntax

Related Commands

Arguments

Miscellaneous

AUTOSet {EXECute|UNDo|VIDeo|VLines|VFields}

DISplay:GRAticule

EXECute autosets the displayed waveform; this is equivalent to pressing the front

panel AUTOSET button. If the display is set to a PAL, MV, or IRE graticule, this argument forces the graticule display to full mode (frame, grid, and cross hair).

FORM:REF3?

. Video arguments require video hardware.) This is equivalent to

might return 5000 if a 5000 point waveform was

Examples

AUXIn:BANdwidth

Group

UNDo returns the instrument to the setting prior to executing an autoset.

VIDeo autosets the displayed waveform.

VLines autosets the displayed waveform.

VFields autosets the displayed waveform.

AUTOSET VFields sets the instrument to trigger on all video ﬁelds.

This command sets or queries the selectable low-pass bandwidth limit ﬁlter of the AUX In input. The bandwidth will change with an appropriate probe attached. This is equivalent to selecting Bandwidth from the Vertical menu.

The query form of this command always returns the m aximum bandwidth of the AUX In input.

Vertical

DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual 2-87

Commands Listed in Alphabetical Order

Syntax

Arguments

Examples

AUXIn:COUPling

Group

AUXIn:BANdwid AUXIn:BANdwidth?

<NR3> is one of the supported bandwidths on the attached probe.

AUXIN:BANDWIDTH 10.0000E+9 sets the bandwidth of AUX In input to

10 GHz.

AUXIN:BANDWIDTH?, for DPO7054 instruments, might return :AUXIN:BANDWIDTH 500.0000E+06, indicating that there is no bandwidth

limiting on the AUX In input.

This command sets or queries the input attenuator coupling setting for the AUX In input. The coupling will change with an appropriate probe attached. This command is equivalent to selecting Coupling from the Vertical menu.

Vertical

th <NR3>

Arguments

Examples

AUXIn:OFFSet

Syntax

AUXIn:COUPling <NR3> AUXIn:COUPling?

<NR3> is one of the supported input attenuator couplings on the attached probe.

AUXIN:COUPLING GND sets the AUX In input to ground.

AUXIN:COUPling? might return :AUXIN:COUPling GND, indicating that AUX

In input is set to GND coupling.

This command sets or queries the vertical offset for the AU command is equivalent to selecting Offset from the Vertical menu.

This command offsets the vertical acq vertical center of the acquisition window) for the input. Visualize offset as scrolling the acquisition window towards the top of a large signal for increased offset values, and scrolling towards the bottom for decreased offset values. The resolution of the vertical window sets the offset increment for this control.

Offset adjusts only the vertical center of the acquisition window to help determine what data is acquired. The instrument always displays the input signal minus the

uisition window (moves the level at the

X In input. This

2-88 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual

Tektronix DSA70000/B Series, DPO70000/B Series, DPO7000 Series Programmer's Manual

Specifications and Main Features

Frequently Asked Questions

User Manual