DPO7000, DPO70000/B And DSA70000/B Series Digital Oscilloscopes Programmer Manual VISA指令集 命令集
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 733
| Download | |
| Open PDF In Browser | View PDF |
xx
ZZZ
DPO7000, DPO70000/B and DSA70000/B Series
Digital Oscilloscopes
Programmer Manual
*P077001006*
077-0010-06
xx
ZZZ
DPO7000, DPO70000/B and DSA70000/B Series
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. 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. Box 500
Beaverton, OR 97077
USA
For product information, sales, service, and technical support:
In North America, call 1-800-833-9200.
Worldwide, 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
.................................................................................................................
Queues ........................................................................................................
Event Handling Sequence...................................................................................
Synchronization Methods ...................................................................................
Appendix A: Character Set .....................................................................................
Appendix B: Reserved Words ..................................................................................
Appendix C: Factory Default Setup Values...................................................................
Default Setup ................................................................................................
Appendix D: GPIB Interface Specifications ..................................................................
Interface Messages .........................................................................................
GPIB Functions .............................................................................................
Glossary
Index
ii
3-3
3-4
3-5
3-6
A-1
B-1
C-1
C-1
D-1
D-1
D-2
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.
Documentation
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 Help. 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 some options for getting data from your instrument into any one
of several available analysis tools.
Specifications and Performance Verification. Instrument specifications
and a performance verification procedure. This is available as a printable
PDF file on the Product Software CD-ROM.
TekVISA Programmer 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 software
for writing interoperable instrument drivers in a variety of Application
Development Environments (ADEs).
Optional Applications Software for Tektronix Windows-Based
Instruments (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
representative.
Other Included Documentation. Installation booklets are included in the
Product Software and Operating System Restore Software packages.
Service 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 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 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 Syntax. 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 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 significant events
that occur within the instrument. Topics that are discussed include registers,
queues, event handling sequences, synchronization methods, and messages
that the instrument may return, including error messages.
Miscellaneous. This topic contains miscellaneous information, such as a
list of reserved words, 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 computer 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
exceptions, these interfaces are completely independent:
HEADER. Command headers enabled or disabled on one interface are
correspondingly enabled or disabled on the other interface. Refer to the
command descriptions for more detailed information.
VERBOSE. 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.
Refer to Documentation for information on related manuals and documents.
Setting Up Remote Communications
Before 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 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 devices on the network should be powered on while
using the network.
Connect the devices 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 instrument 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 specific command.
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
::=
Is defined as
|
Exclusive OR
Defined element
{}
Group; one element is required
[]
.. .
Optional; can be omitted
()
Comment
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 specific action. Queries cause the instrument to return
data 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?. Not all
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: Command Message Elements
Commands
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
(:) character. If the command is concatenated with other commands,
the beginning colon is required. Never use the beginning colon with
command headers beginning with a asterisk (*).
This is a header subfunction. Some command headers have only one
mnemonic. If a command header has multiple mnemonics, a colon (:)
character always separates them from each other.
This is a quantity, quality, restriction, or limit associated with the header.
Some commands have no arguments while others have multiple
arguments. A separates arguments from the header. A
separates arguments from each other.
A single comma is used between arguments of multiple-argument
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 space characters.
Commands cause the instrument to perform a specific function or change one of
the settings. Commands have the structure:
[:][[ ]...]
A command header consists of one or more mnemonics arranged in a hierarchical
or tree structure. The first mnemonic is the base or root of the tree and each
subsequent mnemonic is a level or branch off the previous one. Commands at a
higher level in the tree may affect those at a lower level. The leading colon (:)
always returns you to the base of the command tree.
2-2
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Syntax
Queries
Queries cause the instrument to return status or setting information. Queries
have the structure:
[:]?
[:]?[ []...]
You can specify a query command at any level within the command tree unless
otherwise noted. These branch queries return information about all the mnemonics
below the specified branch or level. For example, 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 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
following 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 or are full-length with the VERBose command.
Concatenating
2-4
You can concatenate any combination of set commands and queries using a
semicolon (;). The instrument executes concatenated commands in the order
received.
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Syntax
When concatenating commands and queries, you must follow these rules:
1. Separate completely different headers by a semicolon and by the beginning
colon on all commands except the first one. For example, the commands
TRIGger:MODe NORMal and ACQuire:NUMAVg 10, can be concatenated
into the following single command:
TRIGger:MODe NORMal;:ACQuire:NUMAVg 10
2. If concatenated commands have headers that differ by only the last mnemonic,
you can abbreviate the second command and eliminate the beginning colon.
For example, you can concatenate the commands ACQuire:MODe ENVelope
and ACQuire:NUMAVg 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
averaging to 10.
4. When you concatenate queries, the responses to all the queries are
concatenated into a single response message. For example, if the display
imageview color is temperature and the display recordview color is spectral,
the concatenated query DISplay:COLOr:PALETTE:IMAGEVIEW?;
RECORDVIEW? will return the following.
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 acquisitions 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
Here are some invalid concatenations:
DISplay:PERSistance:RESET;ACQuire:NUMAVg 10 (no colon before
ACQuire)
DISplay:GRAticule FULl;:FILTer SINX (extra colon before FILTer; use
DISplay:GRAticule FULl;FILTer SINX 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 COLor or place
:DISPlay: in front of COLOr:REFCOLOr INHERIT)
Terminating
This documentation uses (End of message) to represent a message
terminator.
Table 2-4: End of Message Terminator
Symbol
Meaning
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 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.
Cursor Position
Mnemonics
When cursors are displayed, commands may specify which cursor of the pair to
use.
Table 2-5: Cursor Mnemonics
2-6
Symbol
Meaning
CURSOR
A cursor selector; is either 1 or 2.
POSITION
A cursor selector; is either 1 or 2.
HPOS
A cursor selector; is either 1 or 2.
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Syntax
Math Specifier Mnemonics
Commands can specify the mathematical waveform to use as a mnemonic in
the header.
Table 2-6: Math Specifier Mnemonics
Measurement Specifier
Mnemonics
Symbol
Meaning
Math
A math waveform specifier; is 1 through 4.
Commands can specify which measurement to set or query as a mnemonic in the
header. Up to eight automated measurements may be displayed.
Table 2-7: Measurement Specifier Mnemonics
Channel Mnemonics
Symbol
Meaning
MEAS
A measurement specifier; is 1 through 8.
Commands specify the channel to use as a mnemonic in the header.
Table 2-8: Channel Mnemonics
Reference Waveform
Mnemonics
Symbol
Meaning
CH
A channel specifier; is 1 through 4.
Commands can specify the reference waveform to use as a mnemonic in the
header.
Table 2-9: Reference Waveform Mnemonics
Symbol
Meaning
REF
A reference waveform specifier; is 1 thru 4.
Argument Types
Numeric
Many instrument commands require numeric arguments. The syntax shows the
format that the instrument returns in 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
Signed integer value
Floating point value without an exponent
Floating point value with an exponent
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-7
Command Syntax
Most numeric arguments will be automatically forced to a valid setting, either by
rounding or truncating, when an invalid number is input unless otherwise noted
in the command description.
Quoted String
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 is a quoted
string". This documentation represents these arguments as follows:
Table 2-11: Quoted String Argument
Symbol
Meaning
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’ string".
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 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 are not of the same type)
"test" (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
2-8
Symbol
Meaning
A nonzero digit character in the range of 1–9
A digit character, in the range of 0–9
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Syntax
Table 2-12: Block Argument (cont.)
Symbol
Meaning
A character with the hexadecimal equivalent of 00 through FF (0
through 255 decimal)
A block of data bytes defined as: ::=
{#[...][...]
|#0[...]}
specifies the number of elements that follow. Taken together,
the and elements form a decimal integer that specifies how
many elements follow.
NOTE. The digit is in hexadecimal format. This deviates slightly from
the IEEE 488.2 specification that it be in decimal format, as extra allowances
must be made for data lengths that are greater than 999,999,999
elements (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 noted.
Acquisition Command Group
Use the commands 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 successive 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
stopped.
Control acquisition of acquired channel waveforms.
Set acquisition parameters.
Table 2-13: Acquisition Commands
Command
Description
ACQuire?
Returns acquisition parameters
ACQuire:INTERPEightbit
Sets or returns the interpolation acquisition
mode
ACQuire:MODe
Sets or returns acquisition mode
ACQuire:NUMFRAMESACQuired?
Returns the number of acquisitions that have
occurred
ACQuire:NUMACq?
Returns the number of waveform acquisitions
that have occurred since starting acquisition
with the ACQuire:STATE RUN command
ACQuire:NUMAVg
Sets or returns number of acquisitions for an
averaged waveform
ACQuire:NUMEnv
Sets or returns number of acquisitions for
envelope waveform
ACQuire:NUMSAMples
Sets or returns the number of samples that
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
Table 2-13: Acquisition Commands (cont.)
Command
Description
ACQuire:SAMPlingmode
This command sets or queries the sampling
mode
ACQuire:STATE
Starts, stops, or returns acquisition state
ACQuire:STOPAfter
Sets or returns whether the acquisition is
continuous or single sequence
FASTAcq?
Enables, disables, or returns state of Fast
Acquisition mode
FASTAcq:HIACQRATE
Sets or returns the state of FastAcq
optimization for capturing the details with a
higher sample rate
FASTAcq:STATE
Returns the Fast Acquisition state
Alias Command Group
Alias commands allow you to define new commands as a sequence of standard
commands. You may find 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:
The alias name must consist of a valid IEEE 488.2 message unit, which may
not appear in a message preceded by a colon, comma, or a command or query
program header.
The alias name may not appear in a message 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 redefined without first being deleted using one of
the alias deletion functions.
Alias names do not appear in response messages.
The Alias commands are defined in Tektronix Standard Codes and Formats.
Deviations between that standard and what is specified here will be considered
errors unless specifically noted in the command description in this document.
Table 2-14: Alias Commands
2-12
Command
Description
ALIas
Sets or returns the alias state
ALIas:CATalog?
Returns a list of the currently defined alias
labels
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Table 2-14: Alias Commands (cont.)
Command
Description
ALIas:DEFine
Assigns a sequence of program messages
to an alias label
ALIas:DELEte
Removes a specified alias
ALIas:DELEte:ALL
Deletes all existing aliases
ALIas:DELEte:NAMe
Removes a specified alias
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 specific to factory calibration are not described in
this manual; however, they are described in the service manual (located on your
Product Software CD-ROM in PDF format). You can also order a printed copy
(see Recommended Accessories in the online help for the instrument).
Command
Description
CALibrate?
Returns the internal and factory calibration
status
*CAL?
Instructs the instrument to perform
self-calibration and returns the calibration
status when complete
CALibrate:CALProbe:CH?
Performs a probe calibration for the selected
channel and returns the calibration status
CALibrate:INTERNal
Starts the internal signal path calibration
CALibrate:INTERNal:STARt
Starts the internal signal path calibration
CALibrate:INTERNal:STATus?
Returns the current status of the internal
signal path calibration
CALibrate:PRObestate:CH?
Returns the probe calibration status for the
probe of the selected channel
CALibrate:RESults?
Returns the status of all calibration
subsystems without performing an SPC
operation
CALibrate:RESults:SPC?
Returns the results of the last SPC operation
Cursor Command Group
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 cursors have no association with any waveform, other
than they inherit the color of the waveform they are assigned too.
2-14
Command
Description
CURSor?
Returns all cursor settings
CURSor:FUNCtion
Sets or returns the cursor type
CURSor:HBArs?
Returns hbar cursor settings
CURSor:HBArs:DELTa?
Returns hbars cursors vertical difference
CURSor:HBArs:POSITION
Sets or returns the hbar cursor vertical
position
CURSor:HBArs:UNIts?
Returns hbar cursor units
CURSor:LINESTyle
Sets or returns the cursor line style
CURSor:MODe
Sets or returns whether cursors move in
unison or separately
CURSor:SCREEN:STYle
Sets or returns the cursor type for screen
mode
CURSor:SCREEN:XPOSITION
Sets or queries the x position of the specified
screen cursor
CURSor:SCREEN:YPOSITION
Sets or queries the y position of the specified
screen cursor
CURSor:SOUrce
Sets or returns the source for cursor
CURSor:STATE
Turns cursors on or off or returns their state
CURSor:VBArs
Sets or returns the position of vertical bar
cursors
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
CURSor:VBArs:DELTa?
Returns the difference between vbar cursors
CURSor:VBArs:POSITION
Sets or returns the vbar cursor horizontal
position
CURSor:VBArs:POS
Sets or queries the horizontal position for
vertical bar cursors
CURSor:VBArs:UNIts
Sets or returns the units for vbar cursors
CURSor:WAVEform
Sets or returns the current settings for
waveform cursors
CURSor:WAVEform:HDELTA?
Returns the horizontal difference between
waveform cursors
CURSor:WAVEform:HPOS?
Returns the position of waveform cursor
CURSor:WAVEform:POSition
Sets or returns the position of waveform
cursor
CURSor:WAVEform:STYle
Sets or returns the cursor type for waveform
mode
CURSor:WAVEform:UNIts
Sets or returns the units for waveform cursors
CURSor:WAVEform:VDELTA?
Returns the vertical difference between
waveform cursors
CURSor:XY?
Returns the current settings for XY cursors
CURSor:XY:PRODDELta?
Returns the product of the difference
between the cursors X positions and Y
positions
CURSor:XY:PRODUCT?
Returns the product of the X and Y positions
for the specified cursor
CURSor:XY:RADIUS?
Returns the radius of the specified cursor
CURSor:XY:RATDELta?
Returns ratio of the difference between the
cursors X position and Y position
CURSor:XY:RATIO?
Returns ratio of the X (horizontal) and Y
(vertical) position for the specified cursor
CURSor:XY:RDELta?
Returns the Dr value
CURSor:XY:READOUT
Sets or returns the XY cursor readout mode
CURSor:XY:RECTX
Sets or returns the X cursor position in
rectangular coordinates
CURSor:XY:RECTY
Sets or returns the Y cursor position in
rectangular coordinates
CURSor:XY:THDELta?
Returns the XY cursor angle delta in polar
coordinates
CURSor:XY:THETA?
Returns the XY cursor angle in polar
coordinates
CURSor:XY:XDELta?
Returns the XY cursor ΔX value in
rectangular coordinates
CURSor:XY:YDELta?
Returns the XY cursor ΔY value in
rectangular coordinates
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-15
Command Groups
Diagnostics Command Group
The Diagnostic commands control the selection and execution of diagnostic tests.
2-16
Command
Description
DIAg:CONTROL:HALT
Enables or disables halting on first diagnostic
failure
DIAg:CONTROL:LOOP
Enables or disables looping of diagnostics
DIAg:FAILURES:CLEAR
Sets and returns the clearing of pass/fail
information from data structures, not the
Event Log, at the start of diagnostic tests
DIAg:EXECUTE
Executes currently selected set of diagnostics
DIAg:ITEM?
Returns all data associated with a selected
menu item
DIAg:ITEM:FAILURES?
Returns the total number of failures that
occurred
DIAg:ITEM:NAMe?
Returns the name of the selected menu item
DIAg:ITEM:RESULT?
Returns the results of the last test executed
on this item
DIAg:ITEM:SUBITEMS?
Returns the number of subitems associated
with this item
DIAg:LEVEL
Sets the current level of diagnostic test
hierarchy
DIAg:LOOPS?
Returns the number of times the diagnostics
were completed during the last execution
DIAg:NAMe?
Returns the subsystem name, area, and test
name of the current diagnostic test
DIAg:NAMe:AREA?
Returns the selected area of the current
diagnostic test
DIAg:NAMe:SUBSYS?
Returns the subsystem of the current
diagnostic test
DIAg:NAMe:TEST?
Returns the name of the current diagnostic
test
DIAg:NUMITEMS?
Returns the number of items on the currently
selected level of test hierarchy
DIAg:RESults?
Returns a brief pass or fail status of the last
test execution
DIAg:RESults:VERBose?
Returns a more explanatory message about
the results of the last diagnostic execution
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
the same level of test hierarchy
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
DIAg:SELect:SUBSYS
Selects one of the available diagnostic
subsystems
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
of the test hierarchy
TEST:RESults?
Returns a brief pass or fail status of the last
test execution
TEST:RESults:VERBose?
Returns a more explanatory message about
the results of the last test execution
TEST:STOP
Terminates the execution of the test
Display 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
waveform display.
You can set the display of date and time; cursor, histogram, mask, and
measurement readouts; measurement annotations, and the mode in which
waveforms are displayed.
There are six color palettes from which you can select:
Normal. Displays hues and lightness levels for best overall viewing.
Temp. Displays areas of the waveform with the highest sample density in
warmer colors (red shades) while the areas of lowest sample density appear in
cooler colors (blue shades).
Spectral. Displays areas of the waveform with the highest sample density in
blue 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 you choose globally affects all displayed waveforms.
2-18
Command
Description
DISplay?
Returns current display settings
DISplay:CLOCk
Sets or returns the display of the date/time
stamp
DISplay:COLOr?
Returns color group settings
DISplay:COLOr:MATHCOLOr
Sets or returns the color to be used for math
traces
DISplay:COLOr:PALEtte:IMAGEView
Sets or returns the color palette for imageview
waveforms
DISplay:COLOr:PALEtte:RECORDView
Sets or returns the color palette for
recordview waveforms
DISplay:COLOr:PALEtte:USEr
Returns the user palette group settings
DISplay:COLOr:PALEtte:USEr:CARet
Sets or returns the user caret color
DISplay:COLOr:PALEtte:USEr:CH
Sets or returns the user palette channel
colors
DISplay:COLOr:PALEtte:USEr:GRAticule
Sets or returns the user palette graticule
DISplay:COLOr:PALEtte:USEr:HIStogram
Sets or returns the user palette histogram
color
DISplay:COLOr:PALEtte:USEr:MASK
Sets or returns the user palette mask color
DISplay:COLOr:PALEtte:USEr:
MASKHighlight
Sets or returns the user palette mask hits
color
DISplay:COLOr:PALEtte:USEr:MATH
Sets or returns the user palette math colors
DISplay:COLOr:PALEtte:USEr:REF
Sets or returns the user palette reference
colors
DISplay:COLOr:PALEtte:USEr:WAVEform
Sets or queries the user palette waveform
colors
DISplay:COLOr:REFCOLOr
Sets or returns the color to be used for
reference traces
DISplay:FILTer
Sets or returns the type of interpolation to
use for the display
DISplay:FORMat
Sets or returns the display format
DISplay:GRAticule
Sets or returns the type of graticule that is
displayed
DISplay:INTENSITy?
Returns the waveform and graticule
saturation levels
DISplay:INTENSITy:WAVEform:IMAGEView
Sets or returns the waveform saturation level
for imageview waveforms
DISplay:INTENSITy:WAVEform:
RECORDView
Sets or returns the waveform saturation level
for recordview waveforms
DISplay:PERSistence
Sets or returns display persistence setting
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
DISplay:PERSistence:RESET
Clears the persistence data
DISplay:SCREENTExt?
Returns all screen text settings
DISplay:SCREENTExt:LABel?
Sets or returns the screen text setting for a
given label
DISplay:SCREENTExt:LABel:
FONTCOlor
Sets or queries the screen text label font color
DISplay:SCREENTExt:LABel:
FONTNAme
Sets or queries the screen text label font
name for a given label
DISplay:SCREENTExt:LABel:FONTSIze
Sets or queries the screen text label font size
for a given label
DISplay:SCREENTExt:LABel:
FONTSTyle
Sets or queries the screen text label font
style for a given label
DISplay:SCREENTExt:LABel:NAMe
Sets the text to be displayed for a given label
DISplay:SCREENTExt:LABel:STATE
Sets or queries the screen text label state for
a given label
DISplay:SCREENTExt:LABel:XPOS
Sets or returns the horizontal position of a
given label
DISplay:SCREENTExt:LABel:YPOS
Sets or returns the vertical position of a given
label
DISplay:SCREENTExt:STATE
Sets or returns the state of the display of
screen text
DISplay:SHOWREmote
Sets or queries the state of the remote
display feature and is equivalent to selecting
Display Remote from the Display menu
DISplay:STYle
Sets or returns data display style
DISplay:TRIGBar
Sets or returns the display setting of the
trigger level indicator bar(s)
DISplay:TRIGT
Sets or returns the display of the trigger point
indicator
DISplay:VARpersist
Sets or returns the persistence decay time
DISplay:WAVEform
Sets or returns the display of waveform
traces
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), or 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 occurs, the instrument will send an SMTP mail message to one or
more designated recipients through the specified mail server. The message can
include any of the following:
Screen image
Waveform data
Measurement data at the time of the event
NOTE. Your 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.
2-20
Command
Description
EMail
Sends a test e-mail message or sets the
current e-mail sent count to zero
EMail:ATTempts
Sets or queries the number of times that an
attempt will be made to send e-mail to the
SMTP e-mail server
EMail:AUTHLogin
Sets or queries the login name that will be
used if the SMTP e-mail server requires one
for authentication
EMail:AUTHPassword
Sets the password that will be used if
the SMTP e-mail server requires one for
authentication
EMail:COUNt?
Returns the number of e-mails that have
been sent since Email on Event was armed
EMail:FROm
Sets or queries the From line in the e-mail
EMail:HOSTwanted
Sets or queries the hostname that will be
used when e-mail is sent to the SMTP e-mail
server
EMail:IMAGe
Sets or queries whether image data is
included in the e-mail
EMail:MASK
Sets or queries whether e-mail is sent when
a mask test failure occurs
EMail:MAXSize
Sets or queries the maximum size (in
megabytes) of e-mail that can be sent to the
SMTP server
EMail:MEASUrement
Sets or queries whether measurement data
is included in the e-mail
EMail:NUMEMails
Sets or queries the number e-mails that can
be sent when Email onEvent is armed
EMail:SMTPPort
Sets or queries the SMTP port number that
the e-mail server uses
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
EMail:SMTPServer
Sets or queries the address of the SMTP
mail server
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
recipient(s) of an e-mail. Multiple addresses
are separated with a semicolon (;)
EMail:TRIGger
Sets or queries whether e-mail is sent when
a trigger occurs
EMail:WAVEform
Sets or queries whether waveform data is
included in the e-mail
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
Create, copy, read, rename, or delete a file
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\]filename
Path separators may be either forward slashes (/) or back slashes (\)
NOTE. Using back slash as a path separator may produce some unexpected
results, depending on how your controller application treats escaped characters.
Many applications recognize the sequence of back slash followed by an alphabetic
character as an escaped character, and, as such, interpret that alphabetic
character as a control character. For example, the sequence “\n” may be
interpreted as 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:\\testfile.txt”.
Some FILESystem commands may fail because a file has read-only attributes.
You will not be able to delete or replace such files until this attribute is
removed. Refer to the operating system help on file properties for further
information.
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-21
Command Groups
Command
Description
FILESystem?
Returns the file system state
FILESystem:COPy
Copies one or more files to a new file
FILESystem:CWD
Sets or returns the current working directory
for FILESystem GPIB commands
FILESystem:DELEte
Deletes a named file or directory
FILESystem:DIR?
Returns a list of directory contents
FILESystem:MKDir
Makes a new directory
FILESystem:PRInt
Prints a named file to the named port
FILESystem:READFile
Copies the named file to the GPIB port
FILESystem:REName
Assigns a new name to an existing file
FILESystem:RMDir
Deletes the named directory
FILESystem:WRITEFile
Copies the GPIB port block data to a named
file
Hard Copy Command Group
Hard Copy commands enable you to make hard copies of data files or send the
data to a specified file. In addition, these commands provide you with information
about (and the ability to set) file path settings.
2-22
Command
Description
EXPort
Copies a waveform to a specified file or
returns formatting and file information
EXPort:FILEName
Sets or returns the export file path
EXPort:FORMat
Sets or returns the export image format
EXPort:PALEtte
Sets or returns the export color palette
EXPort:READOuts
Sets or returns the position of the readouts
for export
EXPort:VIEW
Sets or returns the export screen capture
area
HARDCopy
Sends a screen copy to the selected port or
returns the selected port and file path
HARDCopy:FILEName
Sets or returns the hard copy file path
HARDCopy:LAYout
Sets or returns the page orientation for hard
copy
HARDCopy:PALEtte
Sets or returns the hard copy color palette
HARDCopy:PORT
Sets or returns whether the hard copy data
will be sent to a file or printed on the next
hard copy command
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
HARDCopy:READOuts
Sets or returns the position of the readouts
for hardcopy
HARDCopy:VIEW
Sets or returns the area of the screen to be
hardcopied
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
Command
Description
HIStogram?
Returns all histogram parameters
HIStogram:BOX
Sets or returns the left, top, right, and bottom
positions of the histogram box, in source
waveform coordinates
HIStogram:BOXPcnt
Sets or returns same as HIStogram:BOX, but
in percentage coordinates, with 0,0 upper left
and 100,100 lower right
HIStogram:COUNt
Clears histogram count source data and
restarts counting
HIStogram:DATa?
Returns a comma-separated list of histogram
data numbers
HIStogram:DISplay
Sets or returns whether histogram data is
displayed and the current display type setting
HIStogram:FUNCtion
Sets the type of histogram to create
Or returns the current histogram type
HIStogram:MODe
Sets type of histogram to create or turns
histograms off
Or returns the current histogram type or that
histogram display is disabled
HIStogram:SIZe
Sets or returns the width (or height) of the
histogram on the screen in divisions
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-23
Command Groups
Command
Description
HIStogram:SOUrce
Sets or returns which source waveform will
be compared against the histogram box
when the histogram testing is enabled
HIStogram:STATE
Sets or returns whether histogram
calculations are enabled
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 first 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.
Command
Description
HORizontal?
Returns all learnable settings for the
horizontal commands
HORizontal:ACQDURATION?
Returns the time base duration
HORizontal:ACQLENGTH?
Returns the record length
HORizontal:DIVisions?
Returns the number of graticule divisions
over which the waveform is displayed
HORizontal:FASTframe?
Returns all settings for the horizontal
FastFrame commands
HORizontal:FASTframe:COUNt
Sets or returns the FastFrame frame count
Sets or returns the horizontal record length
to the number of sample points in each frame
2-24
HORizontal:FASTframe:MAXFRames?
Returns the maximum number of FastFrame
frames which can be acquired at the current
frame length
HORizontal:FASTframe:MULtipleframes:
FRAMESTart:
Sets or returns the start frame number on the
specified waveform for FastFrame multiple
frames
HORizontal:FASTframe:MULtipleframes:
MODe
Sets or returns the mode for FastFrame
multiple frames
HORizontal:FASTframe:MULtipleframes:
NUMFRames:
Sets or returns the number of frames on the
specified waveform for FastFrame multiple
frames
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
HORizontal:FASTframe:REF:FRAme
Sets or returns the FastFrame reference
frame number
HORizontal:FASTframe:REF:SOUrce
Sets or returns the FastFrame Reference
waveform source
HORizontal:FASTframe:SELECTED:CH
Sets or returns the FastFrame selected
frame number on the specified waveform
HORizontal:FASTframe:SELECTED:
MATH
Sets or returns the FastFrame selected
frame number on the specified waveform.
HORizontal:FASTframe:SELECTED:
REF
Sets or returns the FastFrame selected
frame number on the specified waveform
HORizontal:FASTframe:SELECTED:
SOUrce
Sets or returns the FastFrame source
waveform
HORizontal:FASTframe:SEQuence
Sets or returns the FastFrame source
waveform
HORizontal:FASTframe:STATE
Sets or returns the state of FastFrame
acquisition
HORizontal:FASTframe:SUMFrame
Sets or returns the summary frame mode
HORizontal:FASTframe:TIMEStamp:ALL:
?
Returns the frame number and time stamp
for each frame between requested frames,
inclusive, within the specified waveform
HORizontal:FASTframe:TIMEStamp:
BETWeen:?
Returns the relative trigger for the delta time
between the specified frames, within the
specified waveform
HORizontal:FASTframe:TIMEStamp:DELTa:
?
Returns the relative time between the
triggers of the FastFrame Selected and the
FastFrame Reference, within the specified
waveform
HORizontal:FASTframe:TIMEStamp:
FRAMe:?
Returns the absolute trigger date and time
for the specified frame and waveform
HORizontal:FASTframe:TIMEStamp:REF?
Returns the absolute trigger date and time for
the FastFrame specified reference waveform
HORizontal:FASTframe:TIMEStamp:
SELECTED:?
Returns the absolute trigger date and time for
the FastFrame Selected, within the specified
waveform
HORizontal:FASTframe:TRACk
Sets up or returns the state of FastFrame
tracking
HORizontal:FASTframe:XZEro:ALL:CH?
Returns the time from the trigger to the start
of the specified frames on the specified
channel
HORizontal:FASTframe:XZEro:ALL:
REF?
Returns the time from the trigger to the start
of the specified frames on the specified
reference
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-25
Command Groups
2-26
Command
Description
HORizontal:FASTframe:XZEro:FRAme:
CH?
Returns the time from the trigger to the
start of the specified frame on the specified
channel
HORizontal:FASTframe:XZEro:FRAme:
REF?
Returns the time from the trigger to the
start of the specified frame on the specified
reference
HORizontal:FASTframe:XZEro:REF?
Sets or returns the time from the trigger to the
trigger sample on the reference waveform
HORizontal:FASTframe:XZEro:SELECTED:
CH?
Sets or returns the time from the trigger to
the trigger sample on the selected channel
HORizontal:FASTframe:XZEro:SELECTED:
REF?
Sets or returns the time from the trigger to
the trigger sample on the selected reference
waveform
HORizontal:MAIn?
Returns the time per division of the main
time base
HORizontal[:MAIn]:DELay:MODe
Sets or returns the main time base trigger
delay mode
HORizontal[:MAIn]:DELay:POSition
Sets or returns the main time base position
when Horizontal Delay Mode is turned off
HORizontal[:MAIn]:DELay:TIMe
Sets or returns the main time base trigger
delay time
HORizontal:MAIn:INTERPRatio?
Returns the main horizontal time base
interpolation ratio
HORizontal[:MAIn]:POSition
Sets or returns the waveform horizontal
position on the display
HORizontal:MAIn:UNIts
Sets or returns the units for the horizontal
time base
HORizontal:MAIn:UNIts:STRing
Sets or returns the units string for the
horizontal main time base trigger delay
HORizontal:MODE
Sets or queries the horizontal mode. Auto
mode is the factory default
HORizontal:MODE:AUTO:LIMITrecordlen
Sets or queries the record length limit used
by the auto horizontal mode
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?
Returns the absolute trigger date and time
for the specified frame and waveform
HORizontal:TIMEStamp:REF?
Returns the absolute trigger date and time
for FastFrame reference
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Limit Test Command 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 waveform.
Command
Description
LIMit?
Returns all settings for the Limit commands
LIMit:BEEP
Causes the instrument to beep when the
waveform data exceeds the limits set in the
limit test
LIMit:COMpare
Resets the limit test comparison template
LIMit:COMpare:CH
Sets or queries the template against which
to compare the waveform acquired from the
channel specified by x
LIMit:COMpare:MATH
Sets or queries the template against which to
compare the math waveform specified by x
LIMit:COMpare:REF
Sets or queries the template against which to
compare the reference waveform specified
by x
LIMit:EMail
Sets or queries whether an E-mail is
generated when the source waveform data
exceeds the limits specified for the limit test
LIMit:HARDCopy
Sets or queries whether a hard copy
operation is executed on the waveform when
any waveform data exceeds the limit set in
the limit test. LIMit:STATE must be set to ON
for the hard copy operation to execute
LIMit:HIGHLIGHTHits
Sets or queries whether violation highlighting
occurs when limit testing is active, and,
if the RESET argument is set, clears the
highlighting
LIMit:HIGHLIGHTHits:RESet
Resets the hits highlighting for limit testing
LIMit:LOCk
Sets or queries whether vertical scaling and
positioning affect both source and template
for template comparison pairs
LIMit:LOG
Sets or queries whether a log file is saved
when the source waveform data exceeds the
test limits
LIMit:SAVEWFM
Sets or queries whether the source waveform
is saved when the source waveform data
exceeds the test limits
LIMit:SAVEWFM:FILEName
Sets or queries the path where waveforms
or log files will be saved when the waveform
data exceeds the limits set by the limit test
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-27
Command Groups
Command
Description
LIMit:SRQ
Sets or queries whether a Service Request
Interrupt (SRQ) is generated when the
waveform data falls outside of the test limits
LIMit:STATE
Sets limit testing on or off or queries whether
limit testing is in effect
LIMit:STATus?
Queries the state of limit testing
LIMit:STOPOnviolation
Sets or queries whether acquisitions are
stopped when the waveform data exceeds
the test limits
LIMit:TEMPlate:STORe
Saves the specified source waveform to the
specified reference or file name
LIMit:TEMPlate:TOLerance:HORizontal
Sets or queries the amount, in units of
horizontal divisions, by which the source
waveform is varied horizontally when
creating the destination waveform
LIMit:TEMPlate:TOLerance:VERTical
Sets or queries the amount, in units of
vertical divisions, by which the source
waveform is varied vertically when creating
the destination waveform
LIMit:TEMPlate:DESTination
Sets or queries destination reference
waveform that the limit template
LIMit:TEMPlate:SOUrce
Sets or queries the channel, math
waveform, or reference waveform that the
LIMit:TEMPlate:STORe command will use
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
commands are only available with the CAN option.
2-28
Command
Description
TRIGger:A:CAN:CONDition
Sets or returns the CAN condition
TRIGger:A:CAN:DATa:DIRection
Sets or queries the CAN trigger condition to
be valid on a READ, WRITE, or either
TRIGger:A:CAN:FORMat
Sets or queries the CAN data format
TRIGger:A:CAN:DATa:LEVel
Sets or queries the CAN Trigger threshold
for the CAN data source
TRIGger:A:CAN:DATa:SOUrce
Sets or queries the CAN data source
TRIGger:A:CAN:DATa:VALue
Sets or queries the binary data string used
for CAN Trigger if the trigger condition is ID
or IDANDDATA
TRIGger:A:CAN:FRAMEtype
Sets or queries the CAN trigger frame type
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
TRIGger:A:CAN:IDENTifier:MODe
Sets or queries the CAN trigger identifier
mode
TRIGger:A:CAN:IDENTifier:VALue
Sets or queries the binary address string
used for the CAN trigger if the trigger
condition is ID or IDANDDATA
TRIGger:A:CAN:PROBE
Sets or queries the probing method used to
probe the CAN signal
TRIGger:A:CAN:SPEed
Sets or queries the bit rate of the CAN
system
TRIGger:A:I2C:ADDRess:MODe
Sets or queries the I2C address mode to 7
or 10-bit
TRIGger:A:I2C:ADDRess:RWINClude
Sets or queries the I2C address mode to
include the read/write bit as an additional 8th
bit of the 7–bit address
TRIGger:A:I2C:ADDRess:TYPe
Sets or queries the I2C address type
TRIGger:A:I2C:ADDRess:VALue
Sets or queries the binary address string
used for the I2C trigger if the trigger condition
is ADDR or ADDRANDDATA
TRIGger:A:I2C:CLOCk:LEVel
Sets or queries the clock source for the I2C
Serial Trigger
TRIGger:A:I2C:CLOCk:SOUrce
Sets or queries the clock source for the I2C
Serial Trigger
TRIGger:A:I2C:CONDition
Sets or queries the trigger condition for the
I2C trigger
TRIGger:A:I2C:DATa:DIRection
Sets or queries the I2C trigger condition valid
on a READ, WRITE, or either
TRIGger:A:I2C:DATa:LEVel
Sets or queries the threshold level for the
I2C data source
TRIGger:A:I2C:DATa:SOUrce
Sets or queries the data source for the I2C
serial trigger
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
for I2C triggering if the trigger condition is
DATA or ADDRANDDATA
TRIGger:A:I2C:FORMat
Sets or queries the display format for the I2C
data value
TRIGger:A:RS232:BAUd
Sets or queries the baud rate for RS232
triggering
TRIGger:A:RS232:DATa:LEVel
Sets or queries the threshold for the RS232
data source
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
for RS232 triggering
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-29
Command Groups
2-30
Command
Description
TRIGger:A:RS232:FORMat
Sets or queries the display format for the
RS232 data value
TRIGger:A:RS232:PARity
Sets or queries the state of the RS232 parity
bit
TRIGger:A:SERIAL:BITRate
Sets or queries the clock/data bit rate
TRIGger:A:SERIAL:CLOCk:LEVel
Sets or queries the serial trigger clock level
TRIGger:A:SERIAL:CLOCk:POLarity
Sets or queries the serial clock polarity
TRIGger:A:SERIAL:CLOCk:SOUrce
Sets or queries the serial data source
channel
TRIGger:A:SERIAL:CODe
Sets or queries the signal code
TRIGger:A:SERIAL:DATa:FORMat
Sets or queries how the Pattern string is
formatted
TRIGger:A:SERIAL:DATa:PATtern
Sets or queries the data pattern to allow up
to 64 bit serial patterns
TRIGger:A:SERIAL:DATa:PATtern:NRZ
Sets or queries the data pattern to allow up
to 64 bit serial patterns
TRIGger:A:SERIAL:DATa:PATtern:S8B10B
Sets or queries the data pattern to allow up
to 64 bit serial patterns
TRIGger:A:SERIAL:LOCKLen
Sets or queries the length in bits of the
repeating bit pattern for pattern lock trigger
TRIGger:A:SERIAL:LOCKOffset
Sets or queries the current bit offset into the
pattern lock trigger bit pattern
TRIGger:A:SERIAL:SOUrce
Sets or queries the serial data source
channel
TRIGger:A:SERIAL:STANdard
Sets or queries the standard that identifies
the code and bit rate
TRIGger:A:SERIAL:TRIGgeron
Sets or queries the trigger on a designated
arbitrary bit pattern or lock on a repeating
pattern of known length
TRIGger:A:SPI:CONDition
Sets or queries the trigger condition for SPI
triggering
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
MISO data source
TRIGger:A:SPI:DATa:MISO:SOUrce
Sets or queries the MISO data source for the
SPI trigger
TRIGger:A:SPI:DATa:MISO:VALue
Sets or queries the binary data string used
for the SPI trigger if the trigger condition is
set to MISO or MISOMOSI
TRIGger:A:SPI:DATa:MOSI:ACTIVE
Sets or queries the SPI MOSI polarity
TRIGger:A:SPI:DATa:MOSI:LEVel
Sets or queries the threshold for the SPI
MOSI data source
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
TRIGger:A:SPI:DATa:MOSI:SOUrce
Sets or queries the MOSI data source for the
SPI trigger
TRIGger:A:SPI:DATa:MOSI:VALue
Sets or queries the binary data string used
for the SPI trigger if the trigger condition is
set to MOSI or MISOMOSI
TRIGger:A:SPI:DATa:STARt
Sets or queries the nth data byte on the data
source after the signal on the enable slave
source switches to the polarity specified by
the Slave Select Polarity
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 SCLK
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
(SS) polarity
TRIGger:A:SPI:SS:LEVel
Sets or queries the threshold for the SPI
trigger Slave Select (SS) signal
TRIGger:A:SPI:SS:SOUrce
Sets or queries the SPI trigger Slave Select
(SS) source
Mask Command Group
Use the commands in the Mask Command Group to compare incoming waveforms
against standard or user-defined telecommunications masks. Standard masks are
only available when option MTM is installed. Without option MTM, you need
to define 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
input, sending an E-mail message with specified data, logging the time/date of the
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 the commands 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 specified percentage.
Specify whether to display a readout of hits and the mask on screen. Options
also exist for auto fitting the incoming waveforms to match the mask you
choose.
Select industry-standard masks that support a variety of electrical and optical
communication standards (available only with option MTM).
Define and edit your own custom mask; create an entirely new mask, or use
a standard mask (option MTM only) as a starting reference, and edit it to
meet your needs.
Enable, disable, or reset the mask counts. Once you 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.
2-32
Command
Description
MASK?
Returns the states of all settable mask
parameters
MASK:AUTOAdjust
Optimizes signal position within the mask to
minimize hits
MASK:AUTOAdjust:HDELTA
Sets or returns how far autofit searches
horizontally
MASK:AUTOAdjust:VDELTA
Sets or returns how far autofit searches
vertically
MASK:AUTOSet:AUTOAdjust
Controls what happens at the end of a mask
autoset. If ON, the horz/vert auto adjustment
is run ONCE to potentially improve the result
of mask autoset
MASK:AUTOSet:HPOS
Controls whether the algorithm will attempt to
change the horizontal position of the signal
while attempting to autoset
MASK:AUTOSet:HSCAle
Controls whether the algorithm will attempt to
change the horizontal scale while attempting
to autoset
MASK:AUTOSet:MODe
Controls whether an autoset will be
automatically done after a standard mask is
selected
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
MASK:AUTOSet:OFFSETAdj
Sets autoset not to enforce the rule that,
for pulse standards, requires 0 V to be in a
certain place in the mask. Instead, autoset
will attempt to measure the DC offset in
the signal and use scope offset or position
controls to compensate for the DC offset in
the signal
MASK:AUTOSet:STANdard
Selects the standard mask in autoset
MASK:AUTOSet:TRIGger
Controls if a MASK:AUTOSet affects the
trigger level
MASK:AUTOSet:USER:ONE
Sets or returns the level 1 used by autoset
for user masks
MASK:AUTOSet:USER:TYPe
Sets or returns how autoset scales a mask
MASK:AUTOSet:USER:ZERo
Sets or returns the level 0 used by autoset
for user masks
MASK:AUTOSet:VPOS
Controls whether the autoset algorithm will
affect the vertical position (or offset) of the
signal while attempting to autoset
MASK:AUTOSet:VSCAle
Controls whether the autoset algorithm will
attempt to change the vertical scale while
attempting to autoset
MASK:COPy:USER
Copies the currently displayed mask to the
User mask
MASK:COUNt
Resets to zero the number of hits for all mask
segments on the specified source
MASK:COUNt:FAILURES?
Returns the number of pass/fail tests that
have failed
MASK:COUNt:HITS?
Returns the total number of mask hits on all
mask segments
MASK:COUNt:SEG:HITS?
Returns the number of hits in mask segment
MASK:COUNt:STATE
Sets or returns the mask hits count state
MASK:COUNt:TESTS?
Returns the number of pass/fail tests that
have occurred
MASK:COUNt:TOTal?
Returns the sum of all hits in all mask
segments
MASK:COUNt:VIOLATIONS?
Returns the number of test violations that
have occurred in the current pass/fail test
MASK:COUNt:WAVEFORMS?
Returns the number of waveforms that
have been acquired and processed during
pass/fail testing
MASK:DISplay
Sets or returns whether the defined masks
are displayed on the screen
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-33
Command Groups
2-34
Command
Description
MASK:FILTer
Sets or returns whether the selected optical
reference receiver mask filter is enabled
MASK:HIGHLIGHTHits
Sets or returns whether the hits in a mask
are highlighted in different colors than other
waveform data
MASK:INVert
Controls whether the mask is drawn inverted
MASK:LOCk
Sets or returns the mask lock to waveform
mode
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
pulse amplitude in volts
MASK:MASKPRE:HSCAle
Sets or returns the nominal timing
resolution used to draw the current mask, in
time/division
MASK:MASKPRE:HTRIGPOS
Sets or returns the nominal trigger position
(pulse leading edge) used to draw the current
mask as a fraction of the display width
MASK:MASKPRE:PATTERNBITS
Sets or returns the number of bits used for
serial trigger for the current mask standard
MASK:MASKPRE:PRESAMPBITS
Sets or returns the number of bits before
the (isolated one) pulse leading edge in the
serial trigger pass/fail testing
MASK:MASKPRE:RECOrdlength
Sets or returns the nominal record length for
pulse mask testing
MASK:MASKPRE:TRIGTOSAMP
Sets or returns the time, in seconds, from the
(leading edge) trigger position to the pulse
bit sampling position
MASK:MASKPRE:VOFFSet
Sets or returns the nominal vertical offset,
in volts, used to vertically offset the input
channels
MASK:MASKPRE:VPOS
Sets or returns the nominal vertical position,
in divisions, used to vertically position the
input channels
MASK:MASKPRE:VSCAle
Sets or returns the nominal vertical scale, in
volts per division, used to vertically scale the
input channels
MASK:MASKPRE:WIDth
Sets or returns the nominal bit width in
seconds
MASK:POLarity
Sets or returns the input waveform polarity
for the pass/fail test
MASK:SEG
Deletes the specified mask segment from
the Current mask
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
MASK:SEG:NR_Pt?
Returns the number of points that make up
the specified mask segment of the Current
mask
MASK:SEG:POINTS
Sets or returns the X-Y user coordinates of
all points in the Current mask segment
MASK:SOUrce
Sets or reports which source will be
compared against the mask(s) when
counting is turned on
MASK:STANdard
Deletes the existing mask and sets the
selected standard mask
MASK:STOPOnviolation
Sets or returns the stop on violation setting
MASK:TESt:AUX:COMPLetion
Sets or returns the test:aux on pass/fail test
completion mode
MASK:TESt:AUX:FAILure
Sets or returns the test:aux status on
pass/fail test failure mode
MASK:TESt:BEEP:COMPLetion
Sets or returns the beep on pass/fail test
completion mode
MASK:TESt:BEEP:FAILure
Sets or returns the beep status on pass/fail
test failure mode
MASK:TESt:DELay
Sets or returns the amount of time, in
seconds, to wait after starting pass/fail
testing to evaluate waveforms
MASK:TESt:HARDCopy
Sets or returns the hard copy in pass/fail
failure mode
MASK:TESt:LOG:FAILure
Sets or returns the log status on pass/fail
test failure mode
MASK:TESt:REPeat
Sets or returns the repeat pass/fail test on
completion mode
MASK:TESt:SAMple
Sets or returns the minimum number of
waveform database (WfmDB) points the
instrument can acquire before it stops a
single sequence acquisition or stops running
a mask test
MASK:TESt:SAMple:THReshold
Sets or returns the minimum number of hits in
mask regions needed to cause the pass/fail
status to change from PASSING to FAILING
MASK:TESt:SAVEWFM
Sets or returns the save waveform to file on
failure setting
MASK:TESt:SAVEWFM:FILEName
Sets or returns the name of the directory and
file to use with the MASK:TESt:SAVEWFM
command
MASK:TESt:SRQ:COMPLetion
Sets or returns an SRQ on pass/fail test
completion mode
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-35
Command Groups
2-36
Command
Description
MASK:TESt:SRQ:FAILure
Sets or returns the SRQ status on pass/fail
test failure mode
MASK:TESt:STATE
Sets or returns the state of mask pass/fail
testing
MASK:TESt:STATUS?
Returns the pass/fail test status
MASK:TESt:STOP:FAILure
Sets or returns the stop status on pass/fail
test failure mode
MASK:TESt:THReshold
Sets or returns the number of failed tested
waveforms needed in each pass/fail test to
cause the pass/fail status to change from
PASSING to FAILING
MASK:TESt:WAVEform
Sets or returns the number of waveforms to
test during pass/fail testing
MASK:USER:AMPlitude
Sets or returns the current mask’s nominal
pulse amplitude in volts
MASK:USER:BITRate
Sets or returns the user mask’s bit rate
MASK:USER:HSCAle
Sets or returns the nominal timing resolution
used to draw the mask, in time/division
MASK:USER:HTRIGPOS
Sets or returns the nominal trigger position
(pulse leading edge) used to draw the mask
as a fraction of the display width
MASK:USER:LABel
Sets or returns the label assigned to a user
mask
MASK:USER:PATTERNBITS
Sets or returns the number of bits used for
serial trigger for the User mask standard
MASK:USER:PRESAMPBITS
Sets or returns the number of bits before
the (isolated one) pulse leading edge in the
serial trigger pass/fail testing
MASK:USER:RECOrdlength
Sets or returns the nominal record length for
pulse mask testing
MASK:USER:SEG
Deletes the specified mask segment from
the User mask
MASK:USER:SEG:NR_Pt?
Returns the number of points that make up
the specified User mask segment
MASK:USER:SEG:POINTS
Sets or returns the X-Y user coordinates of
all points in the specified User mask segment
MASK:USER:TRIGTOSAMP
Sets or returns the time, in seconds, from the
(leading edge) trigger position to the pulse
bit sampling position
MASK:USER:VOFFSet
Sets or returns the nominal vertical offset,
in volts, used to vertically offset the input
channels
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
MASK:USER:VPOS
Sets or returns the nominal vertical position,
in divisions, used to vertically position the
input channels
MASK:USER:VSCAle
Sets or returns the nominal vertical scale, in
volts per division, used to vertically scale the
input channels
MASK:USER:WIDth
Sets or returns the nominal bit width in
seconds
RECAll:MASK
Recalls a stored mask as the User mask
SAVe:MASK
Saves the User mask to a mass storage file
Math Command Group
Use the commands in the Math Command Group to create and define math
waveforms. You can define 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 define your math waveform.
The math waveform you create depends on sources listed in the math expression.
If you change these sources, the math waveforms you previously defined will be
affected.
Math expressions can be simple, containing no mathematical computation, such
as CH1, which specifies 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 stops, 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 reflect the changes.
Also, sources must exist but do not need to be displayed to be used in and to
update math waveforms.
Command
Description
MATH?
Returns the specified math waveform
settings
MATH:DEFine
Sets or returns the math waveform
definition for the specified waveform
MATH:FILTer:MODe
Sets or returns the filter rise time parameter
(centered or shifted)
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-37
Command Groups
2-38
Command
Description
MATH:FILTer:RISetime
Sets or returns the filter rise time parameter
MATH:LABel:NAMe
Sets or returns the label string used for
annotating the displayed math waveform
MATH:LABel:XPOS
Sets or returns the X screen offset where the
math waveform label is displayed
MATH:LABel:YPOS
Sets or returns the Y screen offset where the
math waveform label is displayed
MATH:NUMAVg
Sets or returns the acquisition number at
which the averaging algorithm will begin
exponential averaging
MATH:SPECTral?
Returns the specified math waveform
spectral setups
MATH:SPECTral:CENTER
Sets or returns the center frequency of the
spectral analyzer output data span
MATH:SPECTral:GATEPOS
Sets or returns the position of the center of
the gate
MATH:SPECTral:GATEWIDTH
Sets or returns the gate width input to the
spectral analyzer
MATH:SPECTral:LOCk
Sets or returns the state of the spectral
locking for the specified math waveform
MATH:SPECTral:MAG
Sets or returns the units of the SpectralMag
function in the specified math string
MATH:SPECTral:PHASE
Sets or returns the units of the SpectralPhase
function in the specified math string
MATH:SPECTral:REFLevel
Sets or returns the vertical position of the
output data from the spectral analyzer
MATH:SPECTral:REFLEVELOffset
Sets or returns the spectral reference level
offset used for calculating the dB value
MATH:SPECTral:RESBw
Sets or returns the resolution bandwidth of
the spectral analyzer
MATH:SPECTral:SPAN
Sets the top of the frequency span to a value
that is closest to the specified value
Or returns the specified math waveform’s
current frequency span value
MATH:SPECTral:SUPPress
Sets or returns the phase suppression
threshold
MATH:SPECTral:UNWRap
Enables or disables or returns the state of
the phase unwrap of the spectral analyzer
output data
MATH:SPECTral:WINdow
Sets or returns the window function used
to multiply the input data to the spectral
analyzer
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
MATH:UNITString
Sets or returns the units used for the math
waveform; command overrides the default
unit string
MATH:VERTical:POSition
Sets or returns the specified math waveform
vertical position
MATH:VERTical:SCAle
Sets or returns the specified math waveform
vertical scale (per div)
MATHArbflt:FILepath
Sets the file path for a file of filter coefficients
and reads the file
MATHArbflt:READFile
Forces a reread of the filter file for the
specified arbitrary filter
MATHVAR?
Sets or returns all 8 numerical values you
can use within math expressions
MATHVAR:VAR
Sets or returns a numerical value you can
use within math expressions
Measurement Command Group
Use the commands in the Measurement Command Group to control the automated
measurement system.
Up to eight automated measurements can be displayed on the screen. In the
commands, these measurement readouts are named MEAS, where 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.
Because they are computed only when needed, immediate measurements slow the
waveform update rate less than displayed measurements.
Whether you use displayed or immediate measurements, use the VALue query to
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
Description
MEASUrement?
Returns all measurement parameters
MEASUrement:ANNOTation:IMMEDSTAte
Sets or returns the state of immediate
measurement annotation
MEASUrement:ANNOTation:NUMX?
Returns the number of horizontal
measurement annotations being displayed
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-39
Command Groups
2-40
Command
Description
MEASUrement:ANNOTation:NUMY?
Returns the number of vertical measurement
annotations being displayed
MEASUrement:ANNOTation:STATE
Sets or returns the state of visible
measurement annotations
MEASUrement:ANNOTation:TYPe
Sets or returns the type of annotations being
used
MEASUrement:ANNOTation:X?
Returns the value of the specified annotation
MEASUrement:ANNOTation:Y?
Returns the value of the specified annotation
MEASUrement:GATing
Sets or returns the measurement gating
MEASUrement:IMMed?
Returns all immediate measurement setup
parameters
MEASUrement:IMMed:DELay?
Returns information about the immediate
delay measurement
MEASUrement:IMMed:DELay:DIREction
Sets or returns the search direction to use
for immediate delay measurements
MEASUrement:IMMed:DELay:EDGE[1]
Sets or returns the slope of the edge
used for immediate delay “from” waveform
measurements
MEASUrement:IMMed:DELay:EDGE2
Sets or returns the slope of the edge
used for immediate delay “to” waveform
measurements
MEASUrement:IMMed:METHod
Specifies or queries the method used to
calculate the 0% and 100% reference level
for immediate measurements
MEASUrement:IMMed:NOISe
Sets or returns the location of the noise
measurement on the eye waveform
MEASUrement:IMMed:REFLevel?
Returns the reference levels
MEASUrement:IMMed:REFLevel:ABSolute:
HIGH
Sets or returns the high reference level
MEASUrement:IMMed:REFLevel:ABSolute:
LOW
Sets or returns the low reference level
MEASUrement:IMMed:REFLevel:ABSolute:
MID
Sets or returns the middle reference levels
MEASUrement:IMMed:REFLevel:METHod
Sets or returns the method used to calculate
measurements
MEASUrement:IMMed:REFLevel:PERCent:
HIGH
Sets or returns the top level for rise time
(90% level)
MEASUrement:IMMed:REFLevel:PERCent:
LOW
Sets or returns the low level for rise time
(10% level)
MEASUrement:IMMed:REFLevel:PERCent:
MID
Sets or returns the mid levels for
measurements
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
MEASUrement:IMMed:SOUrce
Sets or returns the source to measure “to”
or “from” for phase or delay immediate
measurements
MEASUrement:IMMed:SOUrce:SIGType
Sets or returns the type of input signal used
for the specified measurement source
MEASUrement:IMMed:TYPe
Sets or returns the type of the immediate
measurement
MEASUrement:IMMed:UNIts?
Returns the units of the immediate
measurement
MEASUrement:IMMed:VALue?
Returns the value of the immediate
measurement
MEASUrement:MEAS?
Returns all measurement parameters for the
displayed measurement
MEASUrement:MEAS:COUNt?
Returns the number of values accumulated
since the last statistical reset
MEASUrement:MEAS:DELay?
Returns the delay measurement parameters
for specified measurement
MEASUrement:MEAS:DELay:DIREction
Sets or returns the search direction to use
for delay measurements
MEASUrement:MEAS:DELay:EDGE
Sets or returns the slope of the edge
to use for delay “from” or “to” waveform
measurements
MEASUrement:MEAS:MAXimum?
Returns the maximum value found since the
last statistical reset
MEASUrement:MEAS:MEAN?
Returns the mean value accumulated since
the last statistical reset
MEASUrement:MEAS:METHod
Sets or returns the method used to calculate
the 0% and 100% reference level
MEASUrement:MEAS:MINImum?
Returns the minimum value found since the
last statistical reset
MEASUrement:MEAS:NOISe
Sets or returns the location of the noise
measurement on the eye waveform for
MEAS
MEASUrement:MEAS:REFLevel?
Returns the reference levels
MEASUrement:MEAS:REFLevel:
ABSolute:HIGH
Sets or returns the top level for rise time
(90% level)
MEASUrement:MEAS:REFLevel:
ABSolute:LOW
Sets or returns the low level for rise time
(10%)
MEASUrement:MEAS:REFLevel:
ABSolute:MID
Sets or returns the mid1 or mid2 level for
measurements
MEASUrement:MEAS:REFLevel:
METHod
Sets or returns the reference level units used
for measurement calculations
MEASUrement:MEAS:REFLevel:
PERCent:HIGH
Sets or returns the top level for rise time
(90% level)
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-41
Command Groups
2-42
Command
Description
MEASUrement:MEAS:REFLevel:
PERCent:LOW
Sets or returns the low level for rise time
(10% level)
MEASUrement:MEAS:REFLevel:
PERCent:MID
Sets or returns the mid1 or mid2 level for
delay measurements
MEASUrement:MEAS:SOUrce
Sets or returns the source to measure “from”
or “to” for phase or delay measurements
MEASUrement:MEAS:SOUrce:
SIGType
Sets or returns the type of input signal used
for the specified measurement source for the
specified measurement slot
MEASUrement:MEAS:STATE
Sets or returns whether the specified
measurement slot is computed and
displayed
MEASUrement:MEAS:STDdev?
Returns the standard deviation of values
accumulated since the last statistical reset
MEASUrement:MEAS:TYPe
Sets or returns the measurement type
MEASUrement:MEAS:UNIts?
Returns measurement units
MEASUrement:MEAS:VALue?
Returns the value of measurement
MEASUrement:METHod
Sets or returns the method used for
calculating reference levels
MEASUrement:NOISe
Sets or returns the location of the noise
measurement on the eye waveform
MEASUrement:REFLevel:ABSolute:HIGH
Sets or returns the top reference level for
rise time
MEASUrement:REFLevel:ABSolute:LOW
Sets or returns the low reference level for
rise time
MEASUrement:REFLevel:ABSolute:MID
Sets or returns the mid1 or mid2 reference
level for measurements
MEASUrement:REFLevel:METHod
Sets or returns the method for assigning high
and low reference levels
MEASUrement:REFLevel:PERCent:HIGH
Sets or returns the top reference percent
level for rise time
MEASUrement:REFLevel:PERCent:LOW
Sets or returns the low reference percent
level for rise time
MEASUrement:REFLevel:PERCent:MID
Sets or returns the mid1 or mid 2 reference
percent level for waveform measurements
MEASUrement:SOUrce:SIGType
Sets or returns the type of input signal used
for the specified measurement source
MEASUrement:STATIstics:COUNt
Clears existing measurement statistics from
memory
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
MEASUrement:STATIstics:MODe
Turns measurement statistics on or off
and sets or returns which pair of statistical
accumulations is displayed
MEASUrement:STATIstics:WEIghting
Sets or returns the ’time constant’ for
mean and standard deviation statistical
accumulations
Miscellaneous Command Group
Miscellaneous commands do not fit into other categories.
Several commands and queries are common to all 488.2-1987 devices on the
GPIB bus. The 488.2-1987 standard defines these commands. The common
commands begin with an asterisk (*) character.
Command
Description
AUXout?
Returns the auxiliary out setup
AUXout:EDGE
Sets or returns the direction in which the
trigger output signal will transition when a
trigger occurs
AUXout:SOUrce
Sets or returns the trigger source at the BNC
connection
AUTOSet
Sets the vertical, horizontal, and trigger
controls of the instrument to automatically
acquire and display the selected waveform
BELl
In previous models, this command sounded
the audio indicator. Provided for backward
compatibility
CMDBatch
Turns command batching on or off
Or returns the state of command batching
DATE
Sets or returns the date that the instrument
can display
*DDT
Sets or returns the commands that will be
executed by the group execute trigger
HEADer
Sets or returns the Response Header Enable
State
HDR
Sets or returns the Response Header Enable
State
ID?
Returns identifying information about the
instrument and its firmware
*IDN?
Returns the instrument identification code
LOCk
Sets or returns the front panel lock state
*LRN?
Returns a listing of instrument settings
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-43
Command Groups
Command
Description
NEWpass
Changes the password for user protected
data
PASSWord
Provides access for changing user protected
data
REM
Specifies a comment, which is ignored by
the instrument
ROSc:SOUrce
Sets or queries the selected source for the
time base reference oscillator
ROSc:STATE?
Returns whether the time base reference
oscillator is locked
ROSc:TRACking
Sets or queries the selected source for the
time base reference oscillator. The reference
oscillator locks to this source
SET?
Returns a listing of instrument settings
TEKSecure
Initializes both waveform and setup
memories
TIME
Sets or returns the time displayed by the
instrument
*TRG
Performs the group execute trigger (GET)
*TST?
Tests the GPIB interface and returns status
UNLock
Unlocks front panel
VERBose
Sets or returns the verbose state
Save and Recall Command Group
Use the commands in the Save and Recall Command Group to store and retrieve
internal waveforms and settings. When you save a setup, you save all the settings
of the instrument. When you recall a setup, the instrument restores itself to the
state that it was in when you originally saved that setting.
2-44
Command
Description
*RCL
Restores the state of the instrument from a
copy of the setting stored in memory
*SAV
Stores the current instrument state to a
specified memory location
*SDS
Changes the specified setup to reference the
factory setup instead of the user setup
DELEte:SETUp
Removes stored setups from memory and
initializes the location with the factory default
setups
DELEte:WAVEform
Deletes (one or all of) the stored reference
waveforms from memory
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
FACtory
Resets the instrument to factory default
settings
RECAll:SETUp
Recalls saved instrument settings
RECAll:SETUp:DESKew
Sets or queries the deskew values that are
affected by a default setup or a recalled setup
RECAll:WAVEform
Recalls a stored waveform to a reference
location
SAVe:SETUp
Saves the current front panel setup to a
specified memory location or file
SAVe:WAVEform
Saves a waveform to one of four reference
memory locations or a mass storage file
SAVe:WAVEform:FILEFormat
Sets or returns the format for saved
waveforms
SETUp:NAMe
Sets or returns the user-defined setup label
Search and Mark Command Group
Use Search and Mark commands to seek out and identify information in waveform
records that warrant further investigation.
Command
Description
MARK
Moves to the next or previous reference
mark, or queries the current mark setup
MARK:CREATE
Creates a mark on a specified waveform or
all waveforms in a column
MARK:DELEte
Deletes a mark on a particular waveform, all
waveforms in a column, the selected mark,
or all marks
MARK:FREE?
Returns how many marks are available for
use
MARK:SELected:END?
Returns the end of the selected mark, 0 to
100% of the waveform
MARK:SELected:FOCUS?
Returns the focus of the selected mark, 0 to
100% of the waveform
MARK:SELected:LABel
Set or queries the label for the selected mark
MARK:SELected:MARKSINCOLumn?
Returns the number of marks in the current
zoom pixel column
MARK:SELected:OWNer?
Returns the owner of the selected mark
MARK:SELected:SOURCE?
Sets or returns the source waveform for the
selected mark
MARK:SELected:STARt?
Returns the starting point of the selected
mark, 0 to 100% of the waveform
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-45
Command Groups
2-46
Command
Description
MARK:SELected:STATe
Returns the on or off state of the selected
mark. The selected mark is at or near the
center of the display
MARK:SELected:ZOOm:POSition?
Returns the position of the selected mark, 0
to 100% of the zoom overview window
MARK:SELected:ZOOm:SCAle?
Returns the scale of the selected mark, 0 to
100% of the zoom overview window
MARK:TOTal?
Returns how many marks are currently in
use
SEARCH:SEARCH
Converts the specified search marks to the
user marks. can be 1 to 8
SEARCH:SEARCH:COPy
Copies the search criteria to the trigger, the
trigger criteria to a search, or copy search to
search. is the search number
SEARCH:SEARCH:STATE
Selects which search is selected
SEARCH:SEARCH:TOTAL?
Returns the total number of matches for the
search. The total number of matches may
be more than the number of marks placed
SEARCH:SEARCH:TRIGger:A:
DDRMemory:AUTOBitrate
Sets or queries the auto bit rate setting
SEARCH:SEARCH:TRIGger:A:
DDRMemory:AUTOReflevel
Sets or queries the auto reference levels
setting
SEARCH:SEARCH:TRIGger:A:
DDRMemory:BITRate
Sets or queries the DDR memory bit rate
SEARCH:SEARCH:TRIGger:A:
DDRMemory:CSActive
Sets or queries whether the expected
chip-select will be an active HIGH or LOW
SEARCH:SEARCH:TRIGger:A:
DDRMemory:CSLevel
Sets or queries the DDR memory search
chip-select level
SEARCH:SEARCH:TRIGger:A:
DDRMemory:CSMode
Sets or queries the chip-select mode
SEARCH:SEARCH:TRIGger:A:
DDRMemory:CSSource
Sets or queries the chip select source
SEARCH:SEARCH:TRIGger:A:
DDRMemory:DATASource
Sets or queries the DDR memory data
source
SEARCH:SEARCH:TRIGger:A:
DDRMemory:HYSterisis
Sets or queries the hysterisis percent for
DDR memory searches
SEARCH:SEARCH:TRIGger:A:
DDRMemory:REFLevel:DATA:HIGH
Sets or queries the value of the data HIGH
reference level
SEARCH:SEARCH:TRIGger:A:
DDRMemory:REFLevel:DATA:LOW
Sets or queries the value of the data LOW
reference level
SEARCH:SEARCH:TRIGger:A:
DDRMemory:REFLevel:DATA:MID
Sets or queries the value of the data MID
reference level
SEARCH:SEARCH:TRIGger:A:
DDRMemory:REFLevel:STROBE:HIGH
Sets or queries the value of the strobe HIGH
reference level
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
Command Groups
Command
Description
SEARCH:SEARCH:TRIGger:A:
DDRMemory:REFLevel:STROBE:LOW
Sets or queries the value of the strobe LOW
reference level
SEARCH:SEARCH:TRIGger:A:
DDRMemory:REFLevel:STROBE:MID
Sets or queries the value of the strobe MID
reference level
SEARCH:SEARCH:TRIGger:A:
DDRMemory:STANdard
Sets or queries the DDR standard type for a
DDR Memory analysis search
SEARCH:SEARCH:TRIGger:A:
DDRMemory:STROBEsource
Sets or queries the strobe source for a DDR
Memory analysis search
SEARCH:SEARCH:TRIGger:A:EDGE:
SLOpe:CH
Sets or returns the slope for an edge trigger
search to determine where to place a mark.
is the search number or the channel
number
SEARCH:SEARCH:TRIGger:A:EDGE:
SLOpe:MATH
Sets or returns the slope for an edge trigger
search to determine where to place a mark.
is the search number or the math
waveform number
SEARCH:SEARCH:TRIGger:A:EDGE:
SLOpe:REF
Sets or returns the slope for an edge trigger
search to determine where to place a mark.
is the search number or the reference
waveform number
SEARCH:SEARCH:TRIGger:A:EDGE:
SOUrce
Sets or returns the source waveform for an
edge trigger search to determine where to
place a mark. is the search number
SEARCH:SEARCH:TRIGger:A:GLItch:
POLarity:CH
Sets or returns the polarity for a glitch trigger
search to determine where to place a mark.
is the search number or channel number
SEARCH:SEARCH:TRIGger:A:GLItch:
POLarity:MATH
Sets or returns the polarity for a glitch trigger
search to determine where to place a mark.
is the search number or math waveform
number
SEARCH:SEARCH:TRIGger:A:GLItch:
POLarity:REF
Sets or returns the polarity for a glitch trigger
search to determine where to place a mark.
is the search number or reference
waveform number
SEARCH:SEARCH:TRIGger:A:GLItch:
TRIGIF
Sets or returns the accept or reject state for
a glitch trigger search to determine where to
place a mark. is the search number
SEARCH:SEARCH:TRIGger:A:GLItch:
WIDth
Sets or returns the glitch width for a glitch
trigger search to determine where to place a
mark. is the search number
SEARCH:SEARCH:TRIGger:A:LEVel:
CH
Sets or returns the level for an edge trigger
search to determine where to place a
mark. is the search number or the
channel number. Each channel can have an
independent level
DPO7000, DPO70000/B and DSA7000/B Series Programmer Manual
2-47
Command Groups
2-48
Command
Description
SEARCH:SEARCH:TRIGger:A:LEVel:
MATH
Sets or returns the math waveform level for
an edge trigger search to determine where
to place a mark. is the search number
or math waveform number
SEARCH:SEARCH:TRIGger:A:LEVel:
REF
Sets or returns the specified reference
waveform level for a trigger search
to determine where to place a mark.
SEARCH is the search number and
REF