Tektronix DPO7000 Series Programmer's Manual

xx

DPO7000, DPO70000/B and DSA70000/B Series

Digital Oscilloscopes

ZZZ

Programmer Manual

*P077001006*

077-0010-06

DPO7000, DPO70000/B and DSA70000/B Series

Digital Oscilloscopes

ZZZ

Programmer Manual

xx

www.tektronix.com

077-0010-06

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

Tektronix, Inc.

14200 SW Karl Braun Drive

P.O. B o x 5

00

Beaverton, OR 97077

USA

For product information, sales, service, and technical support:

In North America, call 1-800-833-9200.

Worldw

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:

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

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

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

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

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

Glossary

Index

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

Preface

This programmer manual provides you with the information required to use GPIB

commands for remotely controlling your instrument.

Documentat

ion

Quick Start User Manual. The user manual has information about

installing

and operating the instrument. It also provides concepts and

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

Online H elp. This is an online help system that is integrated with the User

Interface

application that ships with this product. The online help provides

in-depth operation and user interface help.

Getting Started with OpenChoice ™ Solutions Manual. A book that

explores s

ome options for getting data from your instrument into any one

of several available analysis tools.

Speciﬁcations and Perform ance Veriﬁcation. Instrument speciﬁcations

and a perf

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

PDF ﬁle on the Product Software CD-ROM.

TekVISA P rogramm er Manual. This manual is available as a printable

PDF ﬁle on

the Product Software CD-ROM. The manual describes

TekVISA, the Tektronix implementation of the VISA Application

Programming Interface (API). TekVISA is industry-compliant s oftware

for writ

ing interoperable instrument driv ers in a variety of Application

Development Environments (ADEs).

Optional Applications Software for Tektronix Windows-Based

Instru

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

application-speciﬁc programs that you can install and run ﬁve times per

application. To purchase an application, contact your local Tektronix

repres

entative.

Other Included Documentation. Installation booklets are included in the

Product Software and Operating System Restore Software packages.

Servi

ce Manual. The service manual includes procedures to service the

instrument to the module level. This manual is available as a printable

PDF ﬁle on the Product Software CD-ROM.

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

Preface

The programmer

guide is divided into the following major topics:

Getting Started. This topic introduces you to the programming information

and p rovides b asic 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

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

command in the listing to display a detailed description of the command.

Command Sy

ntax. This topic provides an overview of the command syntax

that you use to communicate with the instrument and other general information

about commands, such as how commands a nd queries are constructed, how to

enter commands, constructed mnemonics, and argument types.

Status and Events. This topic d iscuss es 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

that t

he instrument may return, including error messages.

Miscellaneous. This topic contains miscellaneous information, such as a

list o

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

and interface speciﬁcations that may be helpful when using commands to

remotely control the instrument.

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

puter programs that will perform functions such as setting the front

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 TekVISA 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

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

command descriptions for m ore d etailed information.

VERBOS

E. Verbosity enabled or disabled on one interface is correspondingly

enabled or disabled on the other interface. Refer to the command description

for more detailed information.

Most examples in this document require that both

HEADER and VERBOSE are ON.

Refe

rtoDocumentation for information on related manuals and documents.

Setting Up Remote Communications

Bef

ore setting up the instrument for remote communications using the electronic

(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 c onnected 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 devices on the network should be powered on while

using the network.

Connect the device s 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

Your instrum en

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

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.

Setting the GPIB Address

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.

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

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

syntax of these commands and queries. The topics also 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

<>

Deﬁned element

::=

Is deﬁned as

| Exclusive OR

{ } Group; one element is required

[]

Optional; can be omitted

.. .

Previous element(s) may be repeated

( ) Comment

Command and Query Structure

Commands consist of set commands and query commands (usually called

commands and queries). Commands modify instrument settings or tell the

instrument to perform a speciﬁc action. Queries cause the instrument to return

d

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

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

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.

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

Command Syntax

Table 2-2: Comm

and Message Elements

Symbol Meaning

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

(:) characte

r. If the command is concatenated with other commands,

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

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

character always separates them from each other.

<Argument

>

This is a qu

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

Some commands have no arguments w hile others have multiple

arguments. A <space> separates arguments from the header. A

<comma> se

parates arguments from each other.

<Comma> A single c

omma is used between arguments of m ultiple-argument

commands. Optionally, there may be white space characters before

and after the comma.

<Space>

A white space character is used between a command header and the

related argument. O ptionally, a white space may consist of multiple

white sp

ace characters.

Commands

Comman

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

the settings. Commands have the structure:

[:]<H

eader>[<Space><Argument>[<C omma> <Argument>]...]

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

or tr

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

subsequent mnemonic is a level or branch off the previous one. Commands at a

higher level in the tree may affect those at a lower level. The leading colon (:)

always returns you to the base of the command tree.

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

Command Syntax

Queries

Queries cause t

he instrument to return status or setting information. Queries

have the structure:

[:]<Header>?

[:]<Header>?[<Space><Argumen t> [<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.

Headers

You can control whether the instrument re turns headers as part of the query

response. Use the HEADer command to control this feature. If hea der 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 informa tion from the response. The

follo

wing table shows the difference in responses.

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

Query Header Off Header On

TIME?

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

ACQuire:NUMAVg?

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

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 o r are full-length with the VERBose command.

Conc

atenating

You can concatenate any combination of set commands and queries using a

semicolon (;). The instrument executes concatenated c ommands 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

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

TRIGger:MODe NORMal and ACQuire:NU MAVg 10, can be concatenated

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 ENV elope;:ACQuire:N UMAVg 10

3. Never precede a star (*) command w ith 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

aver

aging to 10.

4. When you concatenate queries, the responses to all the queries are

con

catenated into a single response message. For example, if the display

imageview color is temperature and the display recordview color is spectral,

the concatenated query

DISplay:COLOr:PALETTE:IMAGE VIEW?;

RECORDVIEW?

will return the following.

If the header is on:

:DISPLAY:COLOR:PALETTE:IMA GEVIEW TEMPERATURE;

:DISPLAY:COLOR:PALETTE:REC ORDVIEW SPECTRAL

If the header is off:

TEMPERATURE;SPECTRAL

5. Set commands and queries m ay 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 acquisitions for averaging and the acquisition state.

Concatenated commands and queries are executed in the or der received.

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

Command Syntax

Here are some in

valid concatenations:

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

ACQuire)

DISplay:GRAticule FULl;:FILTer SINX (extra colon before FILT

er;

use

DISplay:GRAticule FULl;FILTer SINX instead)

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

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

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

COLor or place

:DISPlay: in front of COLOr:REFCOLOr INHERIT)

Terminating

This documentation uses <EOM> (End of message) to represent a mess age

terminator.

Table 2-4: End of Message Terminator

Symbol Meaning

<EOM>

Message terminator

The end-of-message terminator must be the END message (EOI asserted

concurrently with the last data byte). The last data byte may b e 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>

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

POSITION<x>

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

HPOS<x>

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

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

Command Syntax

Math Speciﬁer Mnemonics

Commands can sp

ecify the mathematical waveform to use as a mnemonic in

the header.

Ta ble 2-6: Math Speciﬁer Mnemonics

Symbol Meaning

Math<x>

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

Measurement Speciﬁer

Mnemonics

Commands can specify

which measurement to set or query as a mnemonic in the

header. Up to eight automated measurements may be displayed.

Ta ble 2-7: Measurement Speciﬁer Mnemonics

Symbol Meaning

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

Channel Mnemonics

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

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.

Argument Types

Numeric

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>

Signed integer value

<NR2> Floating point value without an exponent

<NR3> Floating point value with an exponent

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

Command Syntax

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.

Quoted String

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:

"This i s a quoted

string"

. This documentation represents these arguments as follows:

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’ stri ng".

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

example:

"here is a "" mark".

4. Strings can have upper or lower case characters.

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

END message before the closing delimiter.

6. A carriage return or line feed embedded in a quoted string does n ot 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 are not of the same type)

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

Block

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

Table 2-12: Block Argument

Symbol Meaning

<NZDig>

A nonzero digit character in the range of 1–9

<Dig>

A digit character, in the range of 0–9

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

Page is loading ...

Tektronix DPO7000 Series Programmer's Manual

This manual is also suitable for

Tektronix DPO7000 Series Programmer's Manual

Related papers

Other documents