Page is loading ...
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
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. Specifications 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 find 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 Specifications.................................................................. 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.
Specifications and Perform ance Verification. Instrument specifications
and a perf
ormance verification procedure. This is available as a printable
PDF file on the Product Software CD-ROM.
TekVISA P rogramm er Manual. This manual is available as a printable
PDF file 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-specific programs that you can install and run five 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 file 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 significant 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 specifications 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 configuration. Do not
use loop or parallel configurations.
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 figure.
If necessary, the GPIB connectors can be stacked as shown in the following figure.
Setting the GPIB Address
To function correctly, your instrument must have a unique device address. The
default settings for the GPIB configuration are:
GPIB Address 1
GPIB ModeGPIB Talk/Listen
To change either of the GPIB settings, do the following:
1. Select GPIB Configuration from the Utilities menu.
1-2 DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Getting Started
2. Click the Configuration 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 specificcommand.
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
<>
Defined element
::=
Is defined as
| Exclusive OR
{ } Group; one element is required
[]
Optional; can be omitted
.. .
Previous element(s) may be repeated
( ) Comment
Command and Query Structure
Commands consist of set commands and query commands (usually called
commands and queries). Commands modify instrument settings or tell the
instrument to perform a specific 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 five element types, defined 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
<Header>
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 (*).
<Mnemonic>
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 specific 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 first mnemonic is the base or root of the tree and each
subsequent mnemonic is a level or branch off the previous one. Commands at a
higher level in the tree may affect those at a lower level. The leading colon (:)
always returns you to the base of the command tree.
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
ecified 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 fi 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 Specifier Mnemonics
Commands can sp
ecify the mathematical waveform to use as a mnemonic in
the header.
Ta ble 2-6: Math Specifier Mnemonics
Symbol Meaning
Math<x>
A math waveform specifier; <x> is 1 through 4.
Measurement Specifier
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 Specifier Mnemonics
Symbol Meaning
MEAS<x> A measurement specifier; <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 specifier; <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 specifier; <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 defined 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
/
