Tektronix DSA8300 Programmer

xx

DSA8300 Series

ZZZ

DigitalSerialAnalyzer

Programmer Manual

*P077057000*

077-0570-00

xx

DSA8300 Series

ZZZ

Digital Serial Analyzer

Programmer Manual

www.tektronix.com

077-0570-00

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.

IConnect and BERTScope are registered trademarks of Tektronix, Inc.

TekVISA is a trademark of Tektronix, Inc.

Contacting Tektronix

Tektronix, Inc.
14150 SW Karl Braun Drive
P.O. Box 5 0 0
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-3

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

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

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

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

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

Argument Types........... .................................. ................................ ................. 2-8

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

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

Calibration Command Group............................................................................. 2-12

Compensation Command Group ......................................................................... 2-13

Cursor Command Group ......................... .................................. ....................... 2-15

Display Control Command Group .... ................................ .................................. . 2-16

Hard Copy Command Group...................... ................................ ....................... 2-17

Histogram Command Group ............................................................................. 2-18

rizontal Command Group .. ................................ ................................ ........... 2-19

Ho

Mask Command Group ........................ ................................ ........................... 2-23

Math Command Group................... .................................. ............................... 2-25

Measurement Command Group........... ................................ ............................... 2-25

Miscellaneous Command Group ......................................................................... 2-29

Phase Reference Command Group ...................................................................... 2-29

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

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

System Command Group ................................................................................. 2-31

TDR Command Group .................................................................................... 2-34

Trigger Command Group ........................ ................................ ......................... 2-35

Vertical Command Group.......................... ................................ ....................... 2-39

Waveform Database Command Group .................................................................. 2-41

Waveform Transfer Command Group................................................................... 2-43

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

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

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

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

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

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

Messages.................................................................................................... 3-11

DSA8300 Series Programmer Manual i

Table of Contents

Programming Ex

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

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

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

Appendix D: GPIB Interface Specifications........ ................................ .......................... D-1

Index

amples .......................... ................................ ............................... 4-1

ii DSA8300 Series Programmer Manual

Preface

This programmer manual provides you with the information required to u se GPIB
commands for remotely controlling y our instrument. This document supports the
following in

DSA8300 Series

struments:

DSA8300 Series Programmer Manual iii

Preface

iv DSA8300 Series Programmer Manual

Getting Started

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

Besides the traditional GPIB electronic interface (referred to as the physical GPIB
interface), your instrument has a TekV I SA™ 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 in

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

computer programs that will perform functions such as setting the

terfaces are completely independent:

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

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

Most examples in this document assume that both

E. Verbosity enabled or disabled on one interface is correspondingly

HEADER and VERBOSE are ON.

DSA8300 Series Programmer Manual 1-1

Getting Started

The programmer

Getting Started. This section introduces you to the programming information
and provides b
control.

Syntax and C

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.

Command Groups. This section contains all the commands listed by their
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 c a n c
the command.

Comman

commands in alphabetical order and is where you can find the complete
description of each command.

Status and Events. This section discusses the status and event reporting
system for the GPIB interfaces. This syste m 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.

manual is divided into the following major sections:

asic information about setting up your instrument for remote

ommands. This section provides an overview of the command

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

ds Listed in Alphabetical Order. This section contains all the

Appendices. This section contains miscellaneous information, such as a

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

d interface specifications that may be helpful when using commands to

an
remotely control the instrument.

1-2 DSA8300 Series Programmer Manual

Getting Started

SettingUpRem

Connecting to the

Instrument

ote Communications

Before setting up the instrument for remote communications using the electronic
(physical) GPIB interface, you should familiarize yourself with the following
GPIB require

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

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

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

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

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

Connect the devices on the network in a star or linear configuration. Do not
use loop or parallel configurations.

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.

ments:

share the same device address.

If necessary, the GPIB connectors can be stacked as shown in the figure below.

DSA8300 Series Programmer Manual 1-3

Getting Started

Setting the GPIB Address

Talk/Listen Mode

Controller Mode

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

GPIB Address: 1

GPIB Mode: GPIB Talk/Listen

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

1. Select Utilities > User Preferences.

2. Select the GPIB Configuration Tab.

3. Change the GPIB Address to a unique address.

4. Click OK.

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

The DSA8300 is factory set to Talk/Listen mode, which allows you to control the
instrument via the GPIB port.

You can change the instrument to be a GPIB controller (master), which allows
you to control other devices via the GPIB port.

Off Bus Mode

1-4 DSA8300 Series Programmer Manual

In this mode, the
only available when the instrument is set to GPIB device mode.

NOTE. Switching between Talk/Listen and Controller modes automatically

reboots the instrument.

instrument does not communicate with the GPIB. This mode is

Command Syntax

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

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

Backus-Naur Form

Notation

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

Table 2-1: Symbols for Backus-Naur Form

Symbol Meaning

<>

::=

| Exclusive OR

{ } Group; one element is required

[]
.. .

( ) Comment

Command and Query Structure

mmands consist of set commands and query commands (usually called

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

Defined element

Is defined as

Optional; can be omitted

Previous element(s) may be repeated

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 m ark on the end. For example,
the set command
commands have both a set and a query form. Some commands have set only and
some have query only.

Messages

DSA8300 Series Programmer Manual 2-1

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.

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

Command Syntax

Commands

Table 2-2: Comm

Symbol Meaning

<Header>

<Mnemonic>

<Argument

<Comma> A single c

<Space>

Comman

>

ds cause the instrument to perform a specific function or change one of

and Message Elements

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

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

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

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

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

r. If the command is concatenated with other commands,

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

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

parates arguments from each other.

omma is used between arguments of multiple-argument

ace characters.

the settings. Commands have the structure:

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

[:]<H

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

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

or tr
subsequent mnemonic is a level or branch off the previous one. Commands at a
higher level in the tree may affect those at a lower level. The leading colon (:)
always returns you to the base of the command tree.

2-2 DSA8300 Series Programmer Manual

Command Syntax

Queries

Headers

Queries cause t

he instrument to return status or setting information. Queries

have the structure:

[:]<Header>?

[:]<Header>?[<Space><Argument> [<Coma><Argument>]...]

You can specify a query command at any level within the command tree unless
otherwise noted. These branch queries return information about all the mnemonics
below the sp

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

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 table

shows the difference in responses.

below

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

Query Header Off Header On

TIME?

ACQuire:NUMAVg?

"14:30:00" :TIME"14:30:00"

100

:ACQUIRE:NUMAVG 100

Clearing the Instrument

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

DSA8300 Series Programmer Manual 2-3

Command Syntax

Command Entry

The following rules apply when entering commands:

You can enter commands in upper or lower case.

You can precede any command with white space characters. White space
characters include any combination of the ASCII control characters 00 through
09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal).

The instrument ignores commands consisting of any combination of white
space characters and line feeds.

Abbreviating

atenating

Conc

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

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

If you use the HEADer command to have command headers included as part
of query responses, you can further control whether the returned headers are
abbreviated or are full-length with the VERBose command.

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

2-4 DSA8300 Series Programmer Manual

Command Syntax

When concatena

ting commands and queries, you must follow these rules:

Separate completely different headers by a semicolon and by the beginning
colon on all co

TRIGger:MODe EYE and ACQuire:NUMAVg 10, can be concatenated into

mmands except the first one. For example, the commands

the following single command:

TRIGger:MODe EYE;:ACQuire:NUMAVg 10

If concaten

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

ACQuire:MODe ENVelope

and ACQuire:NUMAVg 10 into a single command:

ACQuire:MODe ENVelope; NUMAVg 10

The longer version works equally well:

ACQuire

:MODe ENVelope;:ACQuire:NUMAVg 10

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

ACQuire:MODe ENVelope;*OPC

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

ACQuire:MODe ENVelope;*OPC;NUMAVg 10 will

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

aging to 10.

aver

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

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

con
state for channel 1 is on and it's polarity is negative, the concatenated query

:TDR:CH1:STEP:STATE?;POLARITY? will return the following.

If the header is on:

DR:CH1:STEP:STATE 1 :TDR:CH1:S TEP:POLARITY MINUS

:T

If the header is off:

1;MINUS

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.

Here are some invalid concatenations:

DISplay:STYle:NORMal;ACQuire:NUMAVg 10 (no colon before ACQuire)

DSA8300 Series Programmer Manual 2-5

Command Syntax

Terminating

DISplay:COLor
DISplay:COLor:CURSor1 1;CURSor2 5 instead)

DISplay:STYl

DISplay:COLor:CURSor1 1;COLor:CURSor2 5 (levels of the mnemonics

are differe
front of

nt; either remove the second use of

COLor:CURSor2 5)

:CURSor1 1;:CURSor2 5

e:NORMal;:*OPC

(colon before a star (*) command)

(extra colon before CURSor2; use

COLor or place :DISplay: in

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

r.

Table 2-4: End of Message Terminator

Symbol Meaning

<EOM>

Message terminator

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

aracter.

This instrument does not support ASCII LF only message termination. The

ument always terminates outgoing messages with LF and EOI. It allows

instr
white space before the terminator. For example,

CR LF.

Constructed Mnemonics

Some header mnemonics specify one of a range of mnemonics. For example,
a channel mnemonic can be CH1, CH2, CH3, ... through CH8. 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 a s CH<x>.

ursor Position

C

Mnemonics

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

Table 2-5: Cursor Mnemonics

Symbol Meaning

CURSOR<x>

POSITION<x>

HPOS<x>

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

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

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

2-6 DSA8300 Series Programmer Manual

Command Syntax

Histogram Statistics

Specifier Mnemonics

Magnified Timebase

Specifier Mnemonics

Mask Specifier Mnemonics

Commands can sp

ecify which Sigma value to return for histogram statistics as a

mnemonic in the header. A Sigma is specified in this way:

Table 2-6: Histogram Statistics Specifier Mnemonics

Symbol Meaning

SIGMA<x> A histogram statistics specifier; <x> is either 1, 2, or 3.

Commands can specify which of two magnified timebases to set or query as a
mnemonic in the header. The magnified timebases are specified in this way:

Table 2-7: Magnified Timebase Specifier Mnemonics

Symbol Meaning

MAG<x> A magnified specifie

r; <x> is 1or 2.

Commands can specify w hich mask to set or query as a mnemonic in the header.
The masks are specified in this way:

Table2-8:MaskSpecifier Mnemonics

Symbol Meaning

MASK<x> A mask specifier; <x> is 1 through 8.

Measurement Specifier

Mnemonics

Channel Mnemonics

Commands can specify which measurement to set or query as a mnemonic in
the header. Up to eight automated measurements may be displayed with each
displayed waveform. The displayed measurements are specified in this way:

Table 2-9: Measurement Specifier Mnemonics

Symbol Meaning

MEAS<x> A measurement specifier; <x> is 1 through 8.

SOURCE<x> A waveform specifier; <x> is either 1 (Source 1 waveform) or 2 (Source

2 waveform).

REFLevel<x>

GATE<x> A gate specifier; <x> is either 1 (Gate 1) or 2 (Gate 2).

A waveform specifier for reference level measurements; <x> is either 1
(Source 1 waveform) or 2 (Source 2 waveform).

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

Table 2-10: Channel Mnemonics

Symbol Meaning

CH<x> A channel specifier; <x> is 1 through 8.

DSA8300 Series Programmer Manual 2-7

Command Syntax

Math Waveform

Mnemonics

Reference Waveform

Mnemonics

Waveform Database

Mnemonics

Commands can sp

ecify the mathematical waveform to use as a mnemonic in

the header.

Table 2-11: Math Waveform Mnemonics

Symbol Meaning

Math<x>

A math waveform specifier; <x> is 1 through 8.

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

Table 2-12: Reference Waveform Mnemonics

Symbol Meaning

REF<x>

A reference waveform specifier; <x> is 1 through 8.

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

Table 2-13: Waveform Database Mnemonics

Symbol Meaning

WFMDB<x>

A waveform database specifier; <x> is 1 through 4.

Argument Types

Numeric

Quoted String

Many instrument commands require numeric arguments. The syn

tax 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-14: Numeric Arguments

Symbol Meaning

<NR1>

<NR2> Floating point value without an exponent

<NR3> Floating point value with an exponent

Signed integer value

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.

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

2-8 DSA8300 Series Programmer Manual

Command Syntax

("). The follow

string"

. This documentation represents these arguments as follows:

ing is an example of a quoted string:

"This is a quoted

Table 2-15: Quoted String Argument

Symbol Meaning

<QString> Quoted string of ASCII text

A quoted string can include any character defined in the 7-bit ASCII character
set. Follo

w 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
previou

srule. Forexample,

"this is an 'acceptable' string".

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

e:

exampl

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

Block

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

Here are some invalid strings:

"Invalid string argument' (quotes are not of the same type)

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

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

S

Table 2-16: Block Argument

Symbol Meaning

<NZDig>

<Dig>

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

<Block>

A nonzero digit character in the range of 1–9

A digit character, in the range of 0–9

through 255 decimal)

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

DSA8300 Series Programmer Manual 2-9

Command Syntax

<NZDig> specifi
the <NZDig> and <Dig> elements form a decimal integer that specifies how
many <DChar> elements follow.

es the number of <Dig> elements that follow. Taken together,

2-10 DSA8300 Series Programmer Manual

Command Groups

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

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 all waveforms are simply acquired, averaged, or enveloped
over successive acquisitions.

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 or saving the c
acquisition is stopped.

87 except where noted.

urrent display to a file when the

Get data on acquired waveforms, histograms, and masks.

Get acquisition parameters.

Clear all acquired data.

Table 2-17: Acquisition Commands

Command Description

ACQuire?

ACQuire:CURRentcount:ACQWfms? Returns acquired waveforms count

ACQuire:CURRentcount:HISTHits?

ACQuire:CURRentcount:HISTWfms? Returns histogram waveforms count

ACQuire:CURRentcount:MASKHits<x>?

ACQuire:CURRentcount:MASKSamples?

ACQuire:CURRentcount:MASKTHits?

ACQuire:CURRentcount:MASKWfms? Returns mask waveforms count

ACQuire:DATA:CLEar Clears all acquired data

ACQuire:MODe Sets or returns acquisition mode

ACQuire:NUMAVg Sets or returns number of acquisitions for an

ACQuire:SAVEFile:SAVEScreen Sets or returns the file to save screen to on

Returns acquisition parameters

Returns histogram hits count

Returns mask hits count

Returns mask samples count

Returns total mask hits count

averaged waveform

acquisition stopped

DSA8300 Series Programmer Manual 2-11

Command Groups

Table 2-17: Acquisition Commands (cont.)

Command Description

ACQuire:SAVEFile:SAVEWfm Sets or returns the file to save waveform

data to on acquisition stopped

ACQuire:STATE Starts, stops, or returns acquisition state

ACQuire:STOPAfter? Returns all stopafter parameters

ACQuire:STOPAfter:ACTion Sets or returns the stopafter action

ACQuire:STOPAfter:BELL Sets or returns whether to sound bell on

acquisition stopped

ACQuire:STOPAfter:CONDition Sets or r eturns the acquisition stopafter

condition

ACQuire:STOPAfter:COUNt Sets or returns the stopafter count value

The stopafter count value is
dependent on the condition set by the
ACQuire:STOPAfter:CONDiton command

ACQuire:STOPAfter:MODe Sets or returns the stopafter mode

Calibration Command Group

The calibration commands provide information about the current state of the
calibration for the mainframe and all resident sampling-module channels.
Additional commands allow you to update portions of the “electronic calibration
sticker” information, to check the protection status of the calibration information,
and to set or query the front-panel DC calibration output.

Command

CALibrate:DATE:CH<x>? Returns date and time of the last sampling

CALibrate:DATE:MAInframe? Returns the date and time of the last

CALibrate:DCCALibrator Sets or returns the value of the DC Calibrator

CALibrate:HOSTinfo:CH<x>? Returns the mainframe model number, serial

CALibrate:LOCK:STATus? Returns the status of the calibration

CALibrate:STATus:CH<x>? Returns calibration status for specified

CALibrate:STATus:MAInframe? Returns calibration status for mainframe

Description

module channel<x> calibration

mainframe calibration

voltage

number, and mainframe channel<x> in which
the sampling module channel was located
during the last calibration information update.

protection mode.

sampling module channel<x>

2-12 DSA8300 Series Programmer Manual

Command Groups

Command

CALibrate:TEMPerature:CH<x>? Returns the difference in ºC between

CALibrate:TEMPerature:MAInframe? Returns the difference in ºC between the

CALibrate:UPDATEinfo:ALLModules

CALibrate:UPDATEinfo:CH<x> Updates the calibration information in the

CALibrate:UPDATEinfo:MAInframe Updates the calibration information in the

Compensation Command Group

The compensation commands provide information a
the compensation for the mainframe and all installed module channels, means
to invoke compensation functions, and management of compensation storage
memory locations.

Description

the current sampling module c hannel<x>
temperature a
at the last calibration information update

current mainframe temperature and the
temperatur
information update

Updates dat
mainframe information for all sampling
modules

nonvolat
channel<x>

nonvolatile memory of the mainframe

nd the temperature recorded

e recorded at the last calibration

e, time, temp and host

ile memory of the sampling module

bout the current state of

There are two nonvolatile compensation storage memory blocks in the mainframe
and each sampling module channel: Factory and User. In addition, there
is a volatile run-time, in-use version of all compensation data, which is the
compensation data actually used during the operation of the instrument. On
power-up the instrument loads the User compensation data into the runtime
compensation array.

Command

COMPensate:ALLModules Compensates all installed modules

COMPensate:CH<x> Compensates the module channel<x> for

COMPensate:DARKLev:CH<x> Compensates the specified optical

COMPensate:DATE:CH<x>? Returns date and time of the current

COMPensate:DATE:MAInframe? Returns date and time of the current in-use

COMPensate:MAInframe Compensates the mainframe for DC

Description

DC variances

channel<x> by removing residual DC offsets
in the entire vertical path

in-use compensation data for the module
channel<x>

compensation data for the mainframe

variances

DSA8300 Series Programmer Manual 2-13

Command Groups

Command

COMPensate:OPTGAIN:CH<x> Compensates optical user wavelength gain

COMPensate:RECAll:FACTory:ALLModules Recalls compensation data for all installed

COMPensate:RECAll:FACTory:CH<x> Recalls compensation data from the

COMPensate:RECAll:FACTory:MAInframe Recalls compensation data from the

COMPensate:RECAll:USER:ALLModules Recalls compensation data for all installed

COMPensate:RECAll:USER:CH<x> Recalls compensation data from the

COMPensate:RECAll:USER:MAInframe Recalls compensation data from the

ensate:RESults?

COMP

COMPensate:RESults:VERBose? Returns results of last compensation,

MPensate:SAVe:USER:ALLModules

CO

COMPensate:SAVe:USER:CH<x> Saves volatile run-time compensation data

COMPensate:SAVe:USER:MAInframe Saves volatile run-time compensation data

COMPensate:STATus:CH<x>? Returns the current compensation status of

COMPensate:STATus:MAInframe? Returns the current compensation status of

Description

(wavelengths and input power)

module chann
factory memories into run-time compensation
memory

nonvolatil
channel<x> into its associated run-time
memory

nonvolat
into its associated run-time mem o ry

module channels from their respective
nonvola
compensation memory

nonvolatile user memory of the module
channe
memory

nonvolatile user memory in the mainframe

ts associated run-time memory

into i

rns brief explanation of the results of the

Retu
last compensation

with a more detailed explanation than the

Pensate:RESults? query returns

COM

ves volatile run-time compensation data

Sa
for all installed modules into their associated
nonvolatile user memories

or the module channel<x> into its nonvolatile

f
user memory

for the mainframe into its nonvolatile user
memory

the specified module channel<x>

the mainframe

els from their nonvolatile

e factory memory of the module

ile factory memory in the mainframe

tile user memories into run-time

l<x> into its associ a ted run-time

2-14 DSA8300 Series Programmer Manual

Command Groups

Command

COMPensate:TEMPerature:CH<x>? Returns the difference in ºC between

COMPensate:TEMPerature:MAInframe? Returns the difference in ºC between the

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.

You can also use the commands to select one of the following cursor functions:

Description

the current temperature of the module
channel<x> an
residing in its in-use run-time compensation
memory

current mai
temperature currently residing in its in-use
run-time compensation memory

d the temperature currently

nframe temperature and the

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.

Wavef orm. Displays waveform cursors, which provide horizontal and
vertical 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).

Command

CURSor?

CURSor:CURSor<x>:COLOR Sets or returns cursor<x> color

CURSor:CURSor<x>:SOUrce Sets or returns cursor<x> waveform source

CURSor:FUNCtion Sets or returns the cursor type

CURSor:HBArs?

CURSor:HBArs:DELTa? Returns hbars cursors vertical difference

CURSor:HBArs:POSition<x> Sets or returns the hbar cursor<x> vertical

CURSor:SELect Sets or returns which cursor is active for

CURSor:VBArs?

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

Description

Returns all cursor parameters

and timebase

Returns hbar cursor parameters

position

front-panel control

Returns vbar cursor parameters

DSA8300 Series Programmer Manual 2-15

Command Groups

Display Contro

Command

CURSor:VBArs:POSition<x> Sets or r eturns the vbar cursor<x> horizontal

CURSor:WAVeform? Returns waveform cursor parameters

CURSor:WAVeform:HDELTa? Returns the horizontal difference between

CURSor:WAV

CURSor:WA

CURSor:WAVeform:VDELTa? Returns the vertical difference between

eform:HPOS<x>?

Veform:POSition<x>

l Command Group

You 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 disp

You can set the following:

Background color (default is black) and foreground color (default is silver).

lay.

Description

position

waveform cu

Returns the

Sets or ret
cursor <x>

waveform cursors

rsors

position of waveform cursor <x>

urns the position of waveform

Cursor, histogram, mask, and measurement annotation colors.

Whether cursor, histogram, mask, and measureme nt readouts are displayed.

Whether measurement annotations are displayed.

Whether waveforms are simply displayed in Normal mode as dots or vectors,
in Variable Persistence mode, or in Infinite Persistence mode.

Whether the instrument uses interpolation to increase sample density of
waveform for record lengths less than 1000 points, and, if interpolation is
used, which type (Sin(x) or Linear).

The style of graticule that underlies the waveforms.

Use the commands to set the style that best displays your waveforms and
graticule display properties. The mode you choose globally affects all displayed
waveforms; fo

r example, you cannot set channel 1 to display in Normal mode and

channel 2 in Variable Persistence mode.

There are four graticule settings:

Frame

Grid

Cross Hair

Full

2-16 DSA8300 Series Programmer Manual

Command Groups

Choose Frame or

Grid for minimum clutter on screen; choose Full or Cross Hair

for ease in taking graticule measurements.

Command

DISplay?

DISplay:COLor?

DISplay:COLor:BACKground Sets or returns graticule background color

DISplay:COLor:CURSor<x> Sets or returns cursor<x> color

DISplay:COLor:FOREground Sets or returns graticule foreground color

DISplay:COLor:HIStogram Sets or returns histogram rectangle and plot

DISplay:COLor:MASK Sets or returns the color of mask polygons

DISplay:CURSReadout Sets or returns the display state of the cursor

DISplay:DATe Turns the Date/Time display on or off or

DISplay:GRAticule?

DISplay:GRAticule:HDIVS? Returns the number of horizontal divisions

DISplay:GRAticule:STYLE Sets or returns the graticule style

DISplay:GRAticule:VDIVS? Returns the number of vertical divisions in

DISplay:HISTReadout Sets or returns the display state of the

DISplay:INTERPolat Sets or returns the display interpolation type

DISplay:MASKReadout Sets or returns the display state of the mask

DISplay:MEASBar Sets or returns the display state of the

DISplay:MEASReadout Sets or returns the display state of the

DISplay:PERSistence Sets or returns the display persistence time

DISplay:SHOWVector Sets or returns the show vector status

DISplay:STYle Sets or returns the display persistence style

DISplay:WFMReadout Sets or returns the display state of the

Description

Returns current display settings

Returns color group settings

color

readout

returns the status of the Date/Time display

Returns all graticule parameters

in graticule

graticule

histogram readout

readout

measurement bar

measurement readout

waveform readout

Hard Copy Command Group

Hard copy commands allow you to make hard copies of your data file or send
hard copy data in various formats to a specified file.

DSA8300 Series Programmer Manual 2-17

Command Groups

Command

HARDCopy Sends a screen copy to the selected port or

HARDCopy:FILEName Sets or returns the hard copy file path

HARDCopy:FORMat Selects the file format when sending

HARDCopy:INKSaver Sets the Ink-saver mode on or off. Ink-saver

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. You can use
commands from this group to do the following:

Select any channe l, math, or reference waveform and create a histogram of
vertical or horizontal values for it.

Adjust the limits of the box that d efine the are
the histogram data is obtained. The histogram box can be set using source
waveform coordinates or percentage-of-display coordinates.

Description

returns the selected port and file path

a hardcopy t
HARDCopy:FILEName command

mode can conserve ink and improve print
quality wh
displays

oafile using the

en printing images of waveform

a on the waveform from which

Create a linear or logarithmic plot of histogram data and set plot size and color.

Clear histogram count and restart.

Turn the display of the histogram on or off.

Set or query the color of the histogram box and histogram plot.

Enable or disable histogram calculations.

Get histogram statistics, such as total hits, mean value, peak-to-peak value,
and standard deviation.

Get all the histogram parameters.

NOTE. You can also export a histogram to a file of comma-separated values. See

the EXPort command for more information.

Command

HIStogram?

HIStogram:BOX Sets or returns the left, top, right, and bottom

Description

Return all histogram parameters

positions of the histogram box, in source
waveform coordinates

2-18 DSA8300 Series Programmer Manual

Command Groups

Command

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

HIStogram:C

HIStogram:

HIStogram:DISplay Sets or returns whether histogram data is

HIStogram:ENABle

HIStogra

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

HIStog

HIStogram:STATistics?

HIStogram:STATistics:HITS?

HIStogram:STATistics:MEAN?

HIStogram:STATistics:MEDIAN?

HIStogram:STATistics:PEAKHits?

HIStogram:STATistics:PKTOPK?

HIStogram:STATistics:SIGMA<x>? Returns population density for ±<x> sigma

IStogram:STATistics:STDdev?

H

HIStogram:STATistics:WAVeforms? Returns the number of waveforms used i n

HIStogram:TYPE Sets or returns whether the histogram is

HIStogram:WFMDB:STATE Sets or returns whether the histogram

OLOr

COUNt

m:MODe

ram:SOUrce

Description

in percentage coordinates, with 0,0 upper left
and 100,100 lo

Sets or retur

Clears hist
restarts counting

displayed on screen

Enables or disables histogram calculations

Returns whether histogram calculations are
enabled

Sets type
vertical or horizontal

Returns the type of histogram

ram on the screen in divisions

histog

Sets or
and timebase (Main, Mag1, or Mag2) for
histogram

Returns all histogram statistics

Returns the histogram total hits value

Returns the histogram mean value

Returns the histogram median value

Returns the histogram peak hits value

Returns the histogram peak to peak value

alue

v

Returns the histogram standard deviation

alue

v

histogram

displayed linearly or logarithmically

counting is on a waveform database

wer right

ns the histogram color

ogram count source data and

of histogram to be done, either

returns the source waveform

Horizontal Command Group

You use the commands from the Horizontal Command Group to control the
timebases of the instrument. You can use these commands to do the following:

DSA8300 Series Programmer Manual 2-19

Command Groups

Set the scale (t

ime, distance or bits per division or screen) of the Main, Mag1,

and Mag2 timebases.

Set the record lengths for the Main, Mag1, and Mag2 timebases.

Get the time of first point and time of last point for the Main, Mag1, and
Mag2 timebases.

Get the sample resolution of the Ma in, Mag1, and Mag2 timebases.

Set the horizontal position for the Main, Mag1, and Mag2 timebases.

Set the horizontal reference for the Main, Mag1, and Mag2 timebases.

Enable or disable the acquisition and display of the Mag1 and Mag2 timebases.

Set timebase units to seconds, bits, or distance.

Set the Dielectric constant or propagation velocity (value is used to convert
time to distance when distance is specified for horizontal units).

Select a communication standard, such as OC192, that automatically sets
the associated bit rate.

Adjust the external 10 MHz reference frequency to ensure that the TDR
timebase locks to the signal.

Set the parameters for FrameScan mode, and turn the mode on or off.

Get the screen resolution of the Main, Mag1, and Mag2 timebases.

Get all the horizontal settings.

Command

AUTOSet:HORizontal Sets or returns the status for the horizontal

HORizontal?

HORizontal:BITS:BITRate Sets or returns the bit rate of the timebase

HORizontal:BITS:STANdard Sets or returns the communication standard

HORizontal:DISTance:DIELectric Sets or returns the dielectric constant

HORizontal:DISPlayscale:BITS

HORizontal:DISPlayscale:DISTance

HORizontal:DISPlayscale:SEConds Sets or queries the display scale mode when

HORizontal:DISTance:PVELocity Sets or returns the propagation velocity

HORizontal:EXT10MHZref:FREQ Sets or returns the frequency of the 10 MHz

Description

Autoset options

Returns all horizontal settings

(or NO Ne) for the bit r ate

sets or queries the display scale mode when
horizontal units are set to BITS.

sets or queries the display scale mode when
horizontal units are set to distance (meters,
feet or inches).

horizontal units are s et to SEConds.

external reference when enabled for TDR
acquisitions

2-20 DSA8300 Series Programmer Manual

Command Groups

Command

HORizontal:FRAMescan:RESET Resets FrameScan acquisition

HORizontal:FRAMescan:SCANBits Sets or returns the number of bits in frame to

HORizontal:FRAMescan:STATE Sets or returns the FrameScan acquisition

HORizontal

HORizonta

HORizontal:MAGnify<x>:RECordlength Sets or returns the Mag<x> timebase record

HORizontal:MAGnify<x>:REFPoint Sets or returns the Mag<x> timebase

HORizo

HORizo

HORizontal:MAGnify<x>:TOFPoint? Returns the Mag<x> timebase time of first

HORizontal:MAGnify<x>:TOLPoint? Returns the Mag<x> timebase time of last

HORi

HORizontal:MAIn? Returns the time per division of the main

HORizontal:MAIn:BITS:POSition Sets or queries the horizontal position for the

ORizontal:MAIn:BITS:SCAle

H

HORizontal:MAIn:POSition Sets or returns the horizontal position for the

HORizontal:MAIn:RECordlength Sets or returns the main timebase record

HORizontal:MAIn:REFPoint Sets or returns the main timebase reference

HORizontal:MAIn:RESolution?

HORizontal:MAIn:SCAle Sets or returns the m ain timebase time per

HORizontal:MAIn:TOFPoint? Returns the main timebase time of first point

HORizontal:MAIn:TOLPoint? Returns the main timebase time of last point

HORizontal:MATH<x>:MAGnify<x>:
POSition?

:MAGnify<x>?

l:MAGnify<x>:POSition

ntal:MAGnify<x>:RESolution?

ntal:MAGnify<x>:SCAle

zontal:MAGnify<x>:VIEW

Description

scan in FrameScan acquisition mode

mode on or of

Returns all Mag<x> timebase settings

Sets or ret
Mag<x> timebase

length

referen

Returns the Mag<x> timebase acquisition
resolut

Sets or
per division

point

t

poin

or returns the Mag<x> timebase view

Sets
on or off

time base

in timebase in bits.

ma

ets or queries the scale (bits per division)

S
for the Main timebase.

main timebase

length

position in percent of record

Returns the main timebase acquisition
resolution

division

Returns the Math<x>"Acquisition" horizontal
position for Mag<x> timebase

f

urns the horizontal position for

ce point in percent

ion

returns the Mag<x> timebase time

DSA8300 Series Programmer Manual 2-21

Command Groups

Command

HORizontal:MATH<x>:MAGnify<x>:
RECordlength?

HORizontal:MATH<x>:MAGnify<x>:
RESolution?

HORizontal

HORizontal
TOFPoint?

HORizontal:MATH<x>:MAGnify<x>:
TOLPoint?

HORizontal:MATH<x>:MAIn:POSition? Returns the Math<x> horizontal position for

HORizon

HORizon

HORizo

HORiz

HORiz

HORizontal:MATH<x>:MAIn:TOLPoint? Returns the Math<x> main timebase time of

HORizontal:REF<x>:MAGnify<x>:POSition? Returns the Reference<x> "Acquisition"

HOR
RECordlength?

HORizontal:REF<x>:MAGnify<x>:
RESolution?

HORizontal:REF<x>:MAGnify<x>:SCAle? Returns the Reference<x> Mag<x> timebase

HORizontal:REF<x>:MAGnify<x>:
TOFPoint?

HORizontal:REF<x>:MAGnify<x>:
TOLPoint?

HORizontal:REF<x>:MAIn:POSition? Returns the Reference<x> "Acquisition"

HORizontal:REF<x>:MAIn:RECordlength? Returns the Reference<x> main timebase

HORizontal:REF<x>:MAIn:REFPoint? Returns the Reference<x> main timebase

:MATH<x>:MAGnify<x>:SCAle?

:MATH<x>:MAGnify<x>:

tal:MATH<x>:MAIn:RECordlength?

tal:MATH<x>:MAIn:REFPoint?

ntal:MATH<x>:MAIn:RESolution?

ontal:MATH<x>:MAIn:SCAle?

ontal:MATH<x>:MAIn:TOFPoint?

izontal:REF<x>:MAGnify<x>:

Description

Returns the Ma
record length

Returns the Math<x> Mag<x> timebase
acquisition resolution

Returns the Math<x> Mag<x> timebase time
per divisio

Returns the Math<x> Mag<x> timebase time
of first poin

Returns th
of last point

main time

Returns the Math<x> main timebase record
length

Returns the Math<x> main timebase

nce position in percent of record

refere

Returns the Math<x> main timebase

ition resolution

acquis

Returns the Math<x> main timebase time

vision

per di

ns the Math<x> main timebase time of

Retur
first point

last point

izontal position for Mag<x> timebase

hor

urns the Reference<x> Mag<x> timebase

Ret
record length

Returns the Reference<x> Mag<x> timebase
screen resolution

ime per division

t

Returns the Reference<x> Mag<x> timebase
time of first point

Returns the Reference<x> Mag<x> timebase
time of last point

horizontal position for main timebase

record length

reference position in percent of record

th<x> Mag<x> timebase

n

t

e Math<x> Mag<x> timebase time

base

2-22 DSA8300 Series Programmer Manual

Command Groups

Mask Command Group

Command

HORizontal:REF<x>:MAIn:RESolution? Returns the Reference<x> main timebase

HORizontal:REF<x>:MAIn:SCAle? Returns the Reference<x> main timebase

HORizontal

HORizontal:REF<x>:MAIn:TOLPoint? Returns the Reference<x> main timebase

HORizontal:UNIts Sets or returns the horizontal units

Mask com

:REF<x>:MAIn:TOFPoint?

mands control standard masks, user-defined masks, and testing against

Description

screen resolution

time per divi

Returns the
time of first point

time of last point

sion

Reference<x> main timebase

masks. A mask is a set of polygonal regions on the screen. Every vertical line
on 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
masks. Unlike limit testing, the inside of a mask is the region where waveform

ould not normally fall.

data w

A telecommunications standard may require up to eight of these masks. Pulse

dards always have two masks. Standards with eye patterns usually have three

stan
masks, but some have four.

use the commands in the Mask C ommand Group to do the following:

You

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 autosetting the incoming waveforms to m atch the mask you

hoose.

c

Select industry-standard masks that support a variety of electrical and optical
communication standards.

Define and edit your own custom m ask; create an entirely new mask, or use a
standard mask 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.

Set the color for the mask polygons.

DSA8300 Series Programmer Manual 2-23

Command Groups

Command

MASK?

MASK:AUTOSet:MODe Sets or returns the mask autoset mode.

MASK:AUTOSet:HILow:METHod Sets or returns the method, Mean or Mode,

MASK:COL

MASK:COU

MASK:C

MASK:COUNt:STATE Sets or returns the mask counting

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

MASK:COUNt:WAVeforms? Returns the number of waveforms used in

MASK

MASK:MARgin:PERCent Sets or returns the mask margin in percent

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

MASK:MASK<x>

MASK:MASK<x>:COUNt? Returns number of hits in mask<x>

MASK:MASK<x>:NR_Pt? Returns number of points in mask<x>

MASK:MASK<x>:POInts Returns the points in the specified mask in

MASK:MASK<x>:POINTSPcnt Sets or returns the points in mask<x>, in

MASK:SOUrce Sets or returns which waveform and

MASK:STANdard Sets or returns the standard communication

MASK:WFMDB:STATE Returns whether a waveform database is

Or

Nt

OUNt:SAMPles?

:DISplay

Description

Return all mas

If AUTO is set, a mask autoset will
automatical
is selected; if MANual is set, mask autoset
for a standard mask runs only if the user
presses the
AUTOSet EXECute command.

that a Mask Autoset uses to determine the
High and Lo

Sets or re

Clear mas
restart counting

Returns all the values for the mask count
paramet

Return
that have gone into mask counting

polygons

ask

the m

or returns whether or not defined masks

Sets
are displayed on the screen

lete all points in mask<x>

De

Returns all mask<x>parameters

waveform coordinates

percentage coordinates, with 0,0 upper left
and 100,100 lower right

timebase will be compared against the
mask(s) when counting is turned on

mask

used as a source for mask counting

k parameters

ly be done after a standard mask

AUTOSET button or sends the

w values

turns the mask color

k counts and source data, and

ers

s the total number of sample points

2-24 DSA8300 Series Programmer Manual

Command Groups

Math Command G

roup

You use the commands in the Math Command Group to create and define
math waveforms. You can define and display up to eight math waveforms
simultaneou

sly. You use the available math functions, such as integration,

differentiation, square root, and natural logs, to define your math waveform.

Math expres

sions can be simple, such as C1, which specifies that a waveform
should show the signal source of channel 1 with no mathematical computation.
Math expressions can also be complex, consisting of 100 plus characters and
comprising many sources, functions, and operators.

Math expressions require at least one source waveform. When the acquisition of
a live waveform stops, so does the acquisition of any math waveforms using
that waveform as a source. When a live waveform update occurs or reference
waveform is altered, math waveforms containing those waveforms as sources are
also upd

ated 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

MATH<x >?

MATH<x>:DEFine

MATH<x>:FILTer:MODe Sets or returns the filter mode for the

MATH<x>:FILTer:RISetime Sets or returns the risetime (bandwidth) of

MATH<x>:NUMavg

MATH<x>:POSition Sets or returns the math<x> vertical position

MATH<x >:SCAle Sets or returns the math<x> vertical scale

MATH<x>:UNIts?

MATH<x>:WFMLabel

Description

Returns math<x> settings

Sets or returns the math<x> definition

math<x> w aveform

the m ath filter function

Sets or returns the number of waveforms
to average for a math waveform for the
math<x> w aveform

(per div)

Returns math units

Sets or returns the label associated with the
math<x> w aveform

Measurement Command Group

You 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 eight measurement slots are
named MEAS<x>, where <x> can be 1 through 8. You use the commands to
do the following:

DSA8300 Series Programmer Manual 2-25

Command Groups

Obtain measure

ment results.

Set and query measurement parameters. You can assign most parameters
differently for each source of a measurement slot.

Select the measurement slot (1 through 8), and turn it on and off.

Select the waveform (Source1) to be measured (or the Source1 and Source2
waveforms for delay and other two-waveform measurements).

Query the value of a specified measurement.

Clear the selected measurement and its statistics.

Select whether the measurement displays annotations (indicating which
portion of the waveform is being measured as well as reference levels for that
measurement) and statistics.

Select whether or not statistics on measurements are computed.

Perform measurements on waveform databases.

Set the signal type for waveform database measurements (Pulse, Eye, or RZ).

Clear the waveform database.

Define measurement regions using gates.

Set slope and direction for delay measurements.

Select a tracking method (algorithm) that is used to track the high and low
value of the waveform.

Enable tracking of the high and low values of the waveform automatically,
and specify a high and/or low value (when tracking is disabled).

Select a reference level calculation method.

Set Hi, Mid, and Low reference values, either as percentages of the high-low
range or as absolute values.

Set measurement parameters to default values.

Command

MEASUrement?

MEASUrement:ALL:VALue?

MEASUrement:ANNOtations:STATE Sets or returns whether the measurement

MEASUrement:LIST Sets or returns a list of defined measurements

MEASUrement:LISTValue? Returns the values of the measurements in

Description

Returns all measurement parameters

Returns all measurement values

shows annotations

for which you want values returned

the list created with the MEASUrement:LIST
command

2-26 DSA8300 Series Programmer Manual

Command Groups

Command

MEASUrement:MEAS<x>:ALL? Returns all measurement statistics values for

MEASUrement:MEAS<x>:EYEWindow Sets or returns the percent of interval

MEASUrement:MEAS<x>:GATing:STATE Sets or returns the gating state (on or o ff) for

MEASUrement:MEAS<x>:JITter Sets or returns the jitter-level crossing for

MEASUrem

MEASUrem

MEASUre

MEASUr

MEASUrement:MEAS<x>:REFLevel<x>? Returns all reference level <x> settings for

MEASUrement:MEAS<x>:REFLevel<x>:
ABSol

MEAS
ABSolute:LOW

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

MEASUrement:MEAS<x>:REFLevel<x>:
MET

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

MEASUrement:MEAS<x>:REFLevel<x>:

ELative:LOW

R

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

MEASUrement:MEAS<x>:SETDefault Sets all measurement values to the

MEASUrement:MEAS<x>:SOUrce<x>:
EDGE?

MEASUrement:MEAS<x>:SOUrce<x>:
EDGE:DIRection

MEASUrement:MEAS<x>:SOUrce<x>:
EDGE:SLOPe

ent:MEAS<x>:MAXimum?

ent:MEAS<x>:MEAN?

ment:MEAS<x>:MINimum?

ement:MEAS<x>:NOISe

ute:HIGH

Urement:MEAS<x>:REFLevel<x>:

Hod

Description

the measurement specified by x

between two e
middle of the region

the measurement specified by x

measureme

Returns measurement statistics maximum
value for

Returns measurement statistics mean value
for measu

Returns m easurement statistics minimum
value fo

Sets or
on the high or low level of the signal

measurement slot <x>

Sets or returns the top reference level in

ute w aveform units

absol

or returns the low reference level in

Sets
absolute w aveform units

Sets or returns the m id reference level in
absolute w aveform units

Sets or returns the method to calculate

erence levels, either as a % of the high-low

ref
range or in absolute vertical units

Sets or returns the high reference level as a
% of the high-low range

Sets or returns the low reference level as a

of the high-low range

%

Sets or returns the mid reference level as a
% of the high-low range

instrument default settings

:EDGE? Returns all edge settings for the
specified measurement

Sets or returns the direction (forward or
backward) that the instrument uses to look
for the rising or falling edge

Sets or returns the slope of the edges used
in delay time measurements

ye crossings centered on the

nt

measurement <x>

rement <x>

r measurement <x>

returns whether noise is measured

DSA8300 Series Programmer Manual 2-27

Command Groups

Command

MEASUrement:MEAS<x>:SOUrce<x>:
GATE<x>?

MEASUrement:MEAS<x>:SOUrce<x>:
GATE<x>:PCT

MEASUremen
GATE<x>:POS

MEASUrement:MEAS<x>:SOUrce<x>:
HILow?

MEASUrement:MEAS<x>:SOUrce<x>:
HILow:ME

MEASUrem
HILow:TRACk:HIGH:ENABle

MEASUrement:MEAS<x>:SOUrce<x>:
HILow:TRACk:HIGH:VALue

MEASUr
HILow:TRACk:LOW:ENABle

MEASUrement:MEAS<x>:SOUrce<x>:
HILow:TRACk:LOW:VALue

Urement:MEAS<x>:SOUrce<x>:WFM

MEAS

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

DB:SIGType

WFM

MEASUrement:MEAS<x>:SOUrce<x>:
WFMDB:STATE

MEASUrement:MEAS<x>:STATE Sets or returns the display of measurement

EASUrement:MEAS<x>:STATIstics:CLEar

M

MEASUrement:MEAS<x>:STDdev?

MEASUrement:MEAS<x>:TYPe Sets or returns the type of measurement for

MEASUrement:MEAS<x>:UNIts? Returns the units for the specified

MEASUrement:MEAS<x>:VALue? Returns the measurement value for the

MEASUrement:STATIstics:ENABle Sets or returns whether or not measurement

MEASUrement:STATIstics:WEIghting Sets o r returns measurement statistics

Pos

t:MEAS<x>:SOUrce<x>:

THod

ent:MEAS<x>:SOUrce<x>:

ement:MEAS<x>:SOUrce<x>:

Description

Returns the specified gate<x> settings for
measurement<x>

Sets or returns the gate endpoint in percent

Sets or retu
units

Returns all high / low values for
measurement<x>

Sets or returns the method for calculating
high / low

Sets or re
off)

Sets or returns the high value used to
calculate a specified measurement on a
specifie

Sets or
off)

Sets or returns the low value used to
calculate a specified measurement on a
speci

Sets
waveform, and, optionally, the timebase on
which measurements are taken

Sets or returns the signal type of the
wav
source

Sets or returns the state of Use WfmDb for
measurement source (on or off)

on or off)

(

lears measurement statistics for

C
measurement<x>

Returns measurement statistics standard
deviation value for measurement<x>

the specified measurement

measurement

specified measurement

statistics are enabled (on or off)

weighting for all measurements

rns the gate endpoint in waveform

levels

turns the tracking high level (on or

d source waveform

returns the tracking low level (on or

fied source waveform

or returns the measurement source

eform database for the measurement

2-28 DSA8300 Series Programmer Manual

Command Groups

Miscellaneou

s 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 defi
(*) character.

Command

APPlication:ACTivate Launches the available optional software

AUTOSet

AUTOSet:STOP Stops autoset

AUTOSet:TYPE Sets or returns the autoset mode (Edge,

AUTOSet:UNDO

DATE

FACtory Sets instrument to factory defaults

FILESystem:READFile? Outputs the specified file to the GPIB port

HEADer

*IDN? Returns identification string

LOCk Sets or returns the front panel lock state

*LRN?

*PSC Sets the power-on clear flag. When false,

SET?

SYNC:TIMEOUT Sets or returns the default synchronization

TIMe

UNLock

VERBose

nes these commands. The common commands begin with an asterisk

Description

applications

Runs autoset

Period, NRZ Eye, RZ Eye, or T DR)

Undoes autoset

Sets or returns the date (yyyy-mm-dd)

with maximum file size of 10 Mb

Sets or returns the Response Header Enable
State

Returns "complete" instrument settings

registers retain their status when power is
restored; when true, registers will be cleared
when power is restored

Tek Learn Mode

timeout for commands that rely upon data
production from the instrument

Sets or returns the time displayed by the
instrument

Unlocks the front panel

Returns the front panel lock state

Sets or returns the response header
abbreviation control command

Phase Reference Command Group

You use the commands in the Phase Reference Command Group to switch to the
Phase Correction timebase. This timebase supports ultra-low trigger jitter (typical
is 200 fsec RMS), improving the fidelity of acquired signals.

DSA8300 Series Programmer Manual 2-29

Command Groups

The 82A04 modul
60G. You can find 82A04 information by clicking the Help button in the Phase
Ref Setup dialog box

Command

PHAseref:C

PHAseref:C

PHAseref:CH<x>:RANge? Returns the Phase Reference module

PHAseref:CH<x>:STAtus? Returns the current Phase Reference

PHAsere

PHAseref:SOUrce Sets or returns the Phase Reference source:

HAR

H<x>:FREQuency

f:MODe

Save and Recall Command Group

You u s
retrieve internal waveforms and settings. When you save a setup, you save all the
settings of the instrument. When you recall a saved setting, the instrument restores
itself to the state that it was in when you originally saved that setting.

e the commands in the Save and Recall Command Group to store and

eisavailableintwoconfigurations: standard and with Option

Description

Initiates a

Sets or retu
Frequency

guaranteed frequency range

Characte

Sets or q
OFF, FREerun, TRIGger, or SSCTrigger

C1 & C2, C3 & C4, C5 & C6, or C7 & C8

Phase Reference Characterization

rns the Phase Reference

rization status

ueries the Phase Correction Mode:

Command

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

FACtory Resets the instrument to factory default

EXPort

EXPort:TYPE

IMPort:CUSTom m ask

RECAll:SETUp

RECAll:WAVEform Recalls a stored waveform into reference

SAVe:SETUp Saves the current instrument settings to a

SAVe:WAVEform Saves waveform in reference or file

Description

waveforms from memory

settings

Exports waveform and histogram data to a
file

Sets or queries the form of the exported
waveform data

Imports and loads the custom mask

Recalls saved instrument settings

location

specified location

2-30 DSA8300 Series Programmer Manual

Command Groups

Status and Err

or Command Group

YouusethecommandsintheStatusandErrorcommandGrouptodeterminethe
status of the instrument and control events. Several commands and queries used
with the inst

488.2–1987 defines these commands and queries. The common commands begin
with an asterisk (*) character.

Command

*CLS Clears sta

*ESE Sets or re

*ESR? Returns the standard Event Status Register

*OPC Sets OPC event when all pending operations

*OPT? Returns a list of installed options

*PSC Sets or returns the power on status flag

*RST Resets the i nstrument to factory default

*SRE Sets or returns the bits in the Service

B?

*ST

*WAI Prevents the instrument from executing

LLEv?

A

USY?

B

DESE Sets or returns the bits in the Device Event

EVENT? Returns event code from the event queue

EVMsg? Returns event code, message from the event

EVQty? Returns number of events in the event queue

ID? Returns identifying information about the

rument are common to all devices on the GPIB bus. The IEEE Std

Description

tus

turns the standard Event Status

Enable Register

are finished

s "1" when all current operations

Return
complete

settings

uest Enable Register

Req

urns the contents of the Status Byte

Ret
Register

further commands until all pending

erations finish

op

Returns all events

Returns instrument status

Status Enable Register

queue

instrument and its firmware

System Command Group

You use the commands in the System Command Group to obtain information
about your system, such as the serial numbers of your instrument, installed

DSA8300 Series Programmer Manual 2-31

Command Groups

modules, and th

e attached probes, the hardware version of the acquisition and

processor circuit boards, and the gains and impedances of attached probes.

Command

SYSTem:PROPerties:CH<x>:BANDwidth? Returns a list of available bandwidth

SYSTem:PROPerties:CH<x>:CAPacitance?

SYSTem:PROPerties:CH<x>:CLKRec? Returns list of available clock recovery

SYSTem:PROPerties:CH<x>:CLKUser? Returns the allowable range of user

SYSTem:PROPerties:CH<x>:DYNamic?

SYSTem:PROPerties:CH<x>:EXTender? Returns extender cable type of the specified

SYSTem:PROPerties:CH<x>:FILTer? Returns a list of available filter selections for

SYSTem:PROPerties:CH<x>:IMPedance?

SYSTem:PROPerties:CH<x>:MODElnum?

SYSTem:PROPerties:CH<x>:NONDestruct?

SYSTem:PROPerties:CH<x>:OPERating?

SYSTem:PROPerties:CH<x>:PRAnge? Queries the Phase Reference module

SYSTem:PROPerties:CH<x>:PRObe:
DYNamic?

SYSTem:PROPerties:CH<x>:PRObe:
IMPedance?

SYSTem:PROPerties:CH<x>:PRObe:
MODElnum?

SYSTem:PROPerties:CH<x>:PRObe:
SCAle?

SYSTem:PROPerties:CH<x>:PRObe:
SERialnum?

Description

selections for the specified channel (optical
modules); for electrical modules, returns
bandwidth characteristic if applicable

Where applicable, returns sampling module
load capacitance of the specified channel

selections for the specified channel

clock-recovery rates for the module
containing CH<x>

Returns sampling module lower and upper
dynamic range limits of the specified channel

channel

the s pecified channel

Where applicable, returns sampling module
input impedance of the specified channel

Returns sampling module model number per
specified channel

Where applicable, returns sampling module
lower and upper maximum nondestructive
range of the specified channel

Where applicable, returns sampling module
lower and upper operating range of specified
channel

frequency range, returning it as part of the
system properties query results

Where applicable, returns the probe lower
and upper dynamic range limits of the
specified channel

Returns impedance of probe attached to
specified channel

Returns probe model number of the probe
attached to the specified channel

Returns the probe scale factor of the probe
attached to the specified channel

Returns serial number of probe attached to
specified channel

2-32 DSA8300 Series Programmer Manual

Command Groups

Command

SYSTem:PROPerties:CH<x>:RISetime?

SYSTem:PROPerties:CH<x>:SERialnum?

SYSTem:PROPerties:CH<x>:TEKPDriver? Returns sampling module TEKPROBE driver

SYSTem:PRO

SYSTem:PROPerties:CH<x>:WLENgth? Returns list of available wavelength

SYSTem:PROPerties:EFEHWver? Returns the version number of the Electrical

SYSTem:

SYSTem:PROPerties:GROup<x>:
TEKPVersion?

SYSTem:PROPerties:MAInframe:KEY? Returns mainframe option key

SYSTem:PROPerties:MAInframe:
MODEl

em:PROPerties:MAInframe:

SYST
SERialnum?

SYSTem:PROPerties:MAInframe:
SWVersion?

SYSTem:PROPerties:MAInframe:

IQueid?

UN

STem:PROPerties:OFEHWver?

SY

SYSTem:PROPerties:OFESERialnum? Returns the serial number of the O ptical

SYSTem:PROPerties:ONTime? Returns on time for current power up in hours

SYSTem:PROPerties:POWerups? Returns number of power ups

SYSTem:PROPerties:PROCHWver? Returns hardware version of Processor

SYSTem:PROPerties:TBHWver? Returns the version of the Timebase (TB)

SYSTem:PROPerties:TBSERialnum? Returns the serial number of the Timebase

SYSTem:PROPerties:TOTalontime?

Perties:CH<x>:TEKPVersion?

PROPerties:EFESERialnum?

num?

Description

Where applica
module risetime characteristic of the
specified channel

Returns sampling module serial

revision nu

Returns sam
version number per channel

selections for the specified channel

Front End

Returns
Front End (EFE) circuit board.

Returns the version number of the specified
TEKPROBE controller

Returns mainframe model number

rns mainframe serial number

Retu

Returns mainframe software version number

Returns mainframe id number

turns the Optical Front-End (OFE) board

Re
version number.

Front End (OFE) circuit board.

circuit board

circuit board in the instrument.

(TB) circuit board.

Returns the total accumulated on time in
hours (across all power cycles)

ble, returns the sampling

mber of specified channel

pling module TEKPROBE

(EFE) circuit board.

the serial number of the Electrical

DSA8300 Series Programmer Manual 2-33

Command Groups

TDR Command Gr

oup

You use the commands in the TDR Command Group to do the following:

Specify TDR step channels (C1 through C8), and select the polarity for each.

Select TDR steps.

Enable and disable acquisition.

Set the TDR

Preset any TDR channel.

Set the channel TDR deskew.

Select the channel TDR units.

Obtain all the TDR parameters.

Preset TDR channel pairs for differential TDR measurements.

on the TDR Incident Edge.

Positi

Command

AUTOSet:TDR:INCident Sets or returns the Incident edge option for

TDR?

CH<x>:DIFfpreset

TDR:

TDR:EXT10MHZref:FREQ Sets or returns the external 10 MHz reference

R:CH<x>:PRESET

TD

R:REF10Mhz

TD

DR:CH<x>:STEP:DESkew

T

TDR:CH<x>:STEP:POLarity Sets or returns the TDR step polarity for the

TDR:CH<x>:STEP:STATE Sets or returns whether the TDR generator

TDR:CH<x>:UNIts Sets or returns the TDR units for the specified

TDR:INTRate

internal clock rate.

Description

R autoset (on or off)

the TD

Returns all TDR parameters

the instrument to predefined differential

Sets
TDR settings for the specified TDR channel
pair

quency used for TDR acquisitions

fre

ts the instrument to predefined TDR

Se
settings for the specified TDR channel

Sets or returns the source (internal or
external) for the TDR 10 MHz reference

requency

f

ets or returns the specified channel TDR

S
deskew (if valid type head in channel)

specified channel

is on or off for the specified channel

channel

Sets or returns the TDR (Internal Clock) rate;
same as TRIG:INT RATE

2-34 DSA8300 Series Programmer Manual

Command Groups

Trigger Comma

nd Group

You use the c ommands in the Trigger Command Group to control all aspects of
triggering for the instrument. You use the commands to do the following:

Set the trigger source for triggering acquisition. You can select from the
following sources:

Clock Sources:

Clock Input/Prescale Trigger (front panel input).

Internal clock recovery sources.

TDR Clock.

Trigger

Free Run.

For Clock Sources you can select one of three acquisition modes (Eye,
Pattern, or Other).

For Internal clock recovery sources you can set and query the clock recovery
data rate.

For TDR triggering you can set the trigger clock rate (25 - 300 kHz).

Direct Input (front panel input).

For Trigger Direct source you can do the following:

Set the signal level and slope (rising or falling) of the trigger.

Set the trigger level to 50% of the trigger signal amplitude.

high frequency triggering hysteresis for improved triggering in specific

Set
instances.

t trigger holdoff, which is the time the instrument waits before arming the

Se
trigger system to accept triggers. Holdoff can help achieve stable triggering.

btain all trigger parameters.

O

Obtain the trigger system status (triggered, not triggered, or stopped).

Set and query Pattern Autosync paramete rs (Pattern Length, Data Rate, Data
to Clock Ratio).

Initiate a Pattern Autosync.

Control and Query USB-attached clock recovery instruments (such as the
Tektronix CR125A, CR175A, or CR286A)

DSA8300 Series Programmer Manual 2-35

Command Groups

Command

AUTOSet:TRIGger Sets whether the trigger Autoset options are

TRIGger?

TRIGger:AUTOSync

TRIGger:AUTOSync:DATARate Sets or returns the AutoSync option for data

TRIGger:

TRIGger:AUTOSync:PLENgth Sets or returns the AutoSync option for

TRIGger:CH<x>:CLKRec:LIST? Returns a list of available clock recovery

TRIGge

TRIGger:CH<x>:CLKRec:USEr Sets a user (custom) clock recovery rate

TRIG

TRIGger:CLKRec:CRC:AUTOSConfigdev Sets or queries the setup auto-save feature

TRIGger:CLKRec:CRC:CAPabilities?

TRIGger:CLKRec:CRC:CLOCKAmplitude Sets o r queries the clock output amplitude of

T

TRIGger:CLKRec:CRC:CREATESTandard Saves a new clock recovery standard to the

TRIGger:CLKRec:CRC:DATARate? Returns the measured data rate (in Hz) from

TRIGger:CLKRec:CRC:DELETESTandard Deletes the named standard from the

TRIGger:CLKRec:CRC:DEVICEName Sets or queries the device name of the

AUTOSync:DCRAtio

r:CH<x>:CLKRec:RANge

ger:CH<x>:CLKRec:VALue

RIGger:CLKRec:CRC:CLOCKOutput

Description

included when autoset executes

Returns the st
options

Returns all t

Autosyncs t
waveform, those pattern sync settings that
have their AutoSync options set

rate selec

Sets or re
data-to-clock ratio selection (on or off)

pattern length selection (on or off)

select

Return
recovery rates for the module containing
CH<x>

to be a
range, which is module-dependent

Returns the rate currently defined as the

clock recovery rate

user

or returns the clock recovery value for

Sets
the s pecified channel

of the connected Clock Recovery instrument

Returns the instrument clock recovery device
capabilities.

he connected Clock Recovery instrument

t

ets or queries the clock output mode of the

S
connected Clock Recovery instrument

non-volatile memory of the connected Clock
Recovery instrument

the connected Clock Recovery instrument

connected Clock Recovery instrument

connected Clock Recovery instrument

atus for the trigger Autoset

rigger parameters

o the currently selected

tion (on or off)

turns the AutoSync option for

ions for the module containing CH<x>

s the allowable range of user clock

specified value within an allowable

2-36 DSA8300 Series Programmer Manual

Command Groups

Command

TRIGger:CLKRec:CRC:EDGEDensity? Returns the measured edge density (in

TRIGger:CLK
EDGEDENSITYMode

TRIGger:CLKRec:CRC:EQUalizer Sets or queries the clock recovery instrument

TRIGger:C

TRIGger:

TRIGger:CLKRec:CRC:HALFRate?

TRIGger:CLKRec:CRC:HWRev? Returns the hardware revision string of the

TRIGger:CLKRec:CRC:LOCKCount? Returns the number of times the connected

TRIGger:CLKRec:CRC:LOCKFp

TRIGger:CLKRec:CRC:LOCKMode Sets or queries the lock mode of the

TRIGger:CLKRec:CRC:LOCKRange Sets or queries the locking range about the

TRIGger:CLKRec:CRC:LOCKState? Returns the lock state of the connected

TRIGger:CLKRec:CRC:LOOPBandwidth Sets or queries the loop bandwidth of the

RIGger:CLKRec:CRC:MODElnum?

T

RIGger:CLKRec:CRC:NOMEDgedensity

T

TRIGger:CLKRec:CRC:NOMFrequency Sets or queries the nominal frequency setting

TRIGger:CLKRec:CRC:PEAKing Sets or queries the peak range of the

TRIGger:CLKRec:CRC:PHASEERRLimit Sets or queries the phase error limit of the

TRIGger:CLKRec:CRC:PHASEERRP2P?

Rec:CRC:

LKRec:CRC:EXPrev?

CLKRec:CRC:FPGarev?

Description

percent) from the connected Clock Recovery
instrument

Sets or queri
setting of the connected Clock Recovery
instrument

equalizer v

Returns the expansion board revision string
of the conn

Returns t
connected Clock Recovery instrument

Returns t

connected Clock Recovery instrument

Clock R
since the last reset

Locks
instrument front panel controls.

connected Clock Recovery instrument

nomi
Clock Recovery instrument

Clock Recovery instrument

nnected Clock Recovery instrument

co

Returns a string with the clock recovery

nstrument identifier information.

i

ets or queries the nominal edge density of

S
the connected Clock Recovery instrument

of the connected Clock Recovery instrument

connected Clock Recovery instrument

connected Clock Recovery instrument

Returns the phase error peak-to-peak
measurement from the connected Clock
Recovery instrument

es the edge density mode

alue.

ected Clock Recovery instrume nt

he FPGA revision string of the

he clock recovery device clock rate.

ecovery instrument has relocked

or unlocks the clock recovery

nal frequency setting of the connected

DSA8300 Series Programmer Manual 2-37

Command Groups

Command

TRIGger:CLKRec:CRC:PHASEERRRMS? Returns the phase error RMS measurement

TRIGger:CLK

TRIGger:CL

TRIGger:CLKRec:CRC:RESETLockcount

TRIGger:CLKRec:CRC:SCONfigdevice Saves the current settings of the connected

TRIGger:CLKRec:CRC:SERIalnum? Returns the serial number of the connected

TRIGger:CLKRec:CRC:STANdard Sets or queries the communications standard

TRIGg

TRIGger:CLKRec:CRC:SUBCLOCKAmpl Sets or queries the sub-rate clock output

TRIGger:CLKRec:CRC:SUBCLOCKDiv Sets or queries the division ratio of the

IGger:CLKRec:CRC:

TR
SUBCLOCKDIVList?

TRIGger:CLKRec:CRC:SUBCLOCKOutput Sets or queries the state of the sub-rate clock

TRIGger:CLKRec:CRC:SWRev? Returns the firmware revision string of the

TRIGger:CLKRec:SOUrce Sets or returns the clock recovery channel

TRIGger:HIFreq Sets or returns the high-frequency hysteresis

TRIGger:HOLDoff Sets or returns the trigger holdoff time

TRIGger:INTRate Sets or returns the TDR (Internal Clock) rate;

TRIGger:LEVel Sets or returns the trigger level

Rec:CRC:RCONfigdevice

KRec:CRC:RELock

er:CLKRec:CRC:STANDARDList?

Description

from the connected Clock Recovery
instrument

Restores the
instrument to the settings from one of the
non-volatile setup locations in the Clock
Recovery In

Causes the c
instrument to search for the data rate

Resets the
connected Clock Recovery instrument

Clock Recovery instrument to one of the
non-vola
Recovery Instrument

Clock Recovery Instrument

of the c

Retur
standards available on the connected Clock
Recovery instrument

itude of the connected Clock Recovery

ampl
instrument

sub-rate clock of the connected Clock

overy instrument

Rec

turns a comma-separated list of available

Re
sub-rate clock divisors of the connected
Clock Recovery instrument

utput of the connected Clock Recovery

o
instrument

connected Clock Recovery instrument

source

same as TDR:IN TR ATE

connected Clock Recovery

strument

onnected Clock Recovery

lock count to zero on the

tile setup locations in the Clock

onnected Clock Recovery instrument

ns a comma-separated list of the

2-38 DSA8300 Series Programmer Manual

Command Groups

Command

TRIGger:SETLevel Sets the trigger level to 50% of the applied

TRIGger:SLOpe Sets or returns the trigger slope

TRIGger:SOUrce Sets or returns the trigger source

TRIGger:STATE?

Ve rtical Command Group

You use th
setup of all live (channel) waveforms for acquisition and to control the display of
channel, reference, and math waveforms. This group contains commands to set
up the vertical parameters for either electrical or optical signals, depending on
the sampling module in use.

You can use the commands in this group to do the following:

Description

signal

Returns the trigger system status

e commands in the Vertical Command Group to control the vertical

Enable or disable the display of any channel, math, or reference waveform.

Set which waveform is affected by the front-panel controls.

e vertical scale for each channel, math, or reference waveform.

Set th

Set the vertical position of a waveform. The vertical position affects only the

lay position of a channel, math, or reference waveform.

disp

Set the offset value to shift the vertical acquisition window to match the

eform data that you want to acquire ( affects only channels).

wav

Set deskew and/or delay values to time align channels.

Set the units for channel waveforms. If you set this value to Auto, the
instrument automatically selects the units. If you set this value to any setting

ther than Auto (Volt, Amp, or Watt), the instrument will apply these units to

o
the vertical axis.

et the external attenuation factor (as a multiplier or as a dB value) on an

S
acquisition channel waveform to a value matching the amount of attenuation
applied externally, before the signal enters the sampling head or probe tip
input.

Set the wavelength to match the wavelength of the optical signal you are using.

Set the type of filtering, if any, you want performed on the selected optical
channel.

Specify bandwidth for use on the selected optical channel.

DSA8300 Series Programmer Manual 2-39

Command Groups

Command

AUTOSet:VERTical Sets or returns whether the vertical Autoset

CH<x>?

CH<x>:ERCAL?

CH<x>:BANd

CH<x>:BANdwidth:VALue Sets or returns the bandwidth for the

CH<x>:DELay Sets or returns the delay time for the

CH<x>:D

CH<x>:E

CH<x>:

CH<x>:FILTer:LIST? Returns filter list for the specified channel

CH<x>:FILTer:VALue Sets the hardware filter for the specified

CH<x>:OFFSet Sets or returns the channel offset

CH<x>:POSition Sets or returns the channel vertical position

CH<x>:SCAle Sets or returns the c hannel vertical scale

<x>:UNIts

CH

H<x>:WFMLabel

C

CH<x>:WLENgth:LIST? Returns the wavelengths available for the

CH<x>:WLENgth:VALue Sets or returns the wavelength for the

REF<x>:POSition Sets or returns the reference vertical position

REF<x>:SCAle Sets or returns the reference vertical scale

REF<x>:WFMLabel

SELect? Returns information on which waveforms are

SELect:CH<x> Sets or returns a waveform (on or off) (main

width:LIST?

ESkew

XTAtten:MODe

EXTAtten:VALue

Description

options are included when Autoset executes

Returns the vertical parameters

Returns whether calibrated extinction ratio
is available for the optical module for the
specified ch

Returns the
specified channel

specified channel

specified

Sets or r

Sets or r

Sets or
factor (as a multiple)

channel

er div)

(p

ts or returns the channel vertical units

Se

ets or returns the label associated with the

S
specified channel waveform

specified channel

specified channel

(per div)

Sets or returns the label associated with the
specified reference waveform

ON/OFF and which waveform is the selected
waveform

timebase)

annel

bandwidths available for the

channel

eturns the deskew time

eturns the external attenuation mode

returns the external attenuation

2-40 DSA8300 Series Programmer Manual

Command Groups

Command

SELect:CONTROl Sets the waveform controlled by front panel.

SELect:MAT

SELect:REF<x> Sets or returns a reference waveform (on or

H<x>

Waveform Database Command Group

You use th
set up a waveform database. A waveform database is a collection of sequentially
acquired waveforms. Think of a waveform database as a three-dimensional array
with a count dimension in addition to the usual vertical and horizontal dimensions.
The count represents the number of times a specific waveform point has been
acquired. Waveform da t abase accumulation is always a dot mode accumulation
(that

e commands in the Waveform Database Command group to view and

is, no interpolation or vectoring is performed).

Description

Note: NONE may be returned by *LRN?.
If this is an ar
timebase is NOT optional

Returns the waveform and timebase selected
for front-pa

Sets or retu
(main timebase)

off) (main timebase)

gument, do nothing. Also,

nel control

rns a math waveform (on or off)

Waveform database count values stored in the waveform database array are

-less with respect to absolute user units (for example, volts or seconds). They

unit
are described by the attributes of the source waveform along with the overall
dimensions of the array.

The following are the dimensions of a waveform database:

izontal (columns). Value is 1000, which is the maximum horizontal

Hor
graticule view size.

rtical (rows). Value is 402, which is the maximum vertical graticule view

Ve
size in pixels, p lus one row each for the overrange (OR) and the underrange
(UR) counts for each column.

Count (weights or density). Value is 32 bits.

Use waveform databases for measurements, histogram calculations and display,
mask testing, and generating a density-style graded display. If a waveform
database is turned on for the selected source, then the mask testing, histogram
calculations, and measurements can use the waveform database.

DSA8300 Series Programmer Manual 2-41

Command Groups

You can use the c

ommands in this group to do the following:

Set the source to which the waveform database is assigned.

Enable or disable the waveform database.

Set whether the waveform database is displayed.

Set whether you want the waveform database drawn with color or intensity
grading.

Set the display emphasis for the waveform database. The value you specify
sets the range of counts you want emphasized. The lowest value, 0,
emphasizes bins with low counts; the highest value, 100, emphasizes bins
with high counts.

Invert the mapping function that applies colors and intensity to the waveform
database to significantly emphasize the least occurring pixels.

Clear the specified waveform database.

Obtain all the waveform database display parameters.

Obtain all the waveform database parameters.

nd

Comma

B?

WFMD

B:DISPlay?

WFMD

DB:DISPlay:EMPHasis

WFM

DB:DISPlay:GRADing

WFM

MDB:DISPlay:GRADMethod

WF

WFMDB:DISPlay:INVert Sets or returns the WfmDB grading inversion

WFMDB:WFMDB<x>? Returns WfmDB<x> parameters

WFMDB:WFMDB<x>:CLEar Deletes (clears) resource of speci fied

WFMDB:WFMDB<x>:DISplay Sets or returns the WfmDB<x> displayed

WFMDB:WFMDB<x>:ENABle

WFMDB:WFMDB<x>:PERSistence:COUNt Sets or returns the waveform count

WFMDB:WFMDB<x>:PERSistence:MODe Sets or returns the persistence mode (Infinite

WFMDB:WFMDB<x>:PERSistence:
SAMPles?

WFMDB:WFMDB<x>:SOURce Sets or returns the W fmDB <x> source

Description

rns all WfmDB parameters

Retu

Returns wWmDB display parameters

s or returns the WfmDB display emphasis

Set

s or returns the WfmDB grading type

Set

ts or returns the WfmDB grading method

Se
to any one of four available methods

WfmDB

Sets or returns whether the specified
waveform database is enabled

applied to WfmDB<x> when set to Variable
Persistence mode

or Variable) used by WfmDB<x>

Returns the samples count in effect
for WfmDB<x> when using in Variable
Persistence mode

2-42 DSA8300 Series Programmer Manual

Command Groups

Waveform Tran

Data Formats

sfer Command Group

Use the commands i n the Waveform Transfer Command Group to transfer
waveform data points to and f rom the instrument. Waveform data points are a
collection o
one data point in the waveform record. When working with envelope waveforms,
each data value is either the minimum or the maximum of a min/max pair.

Before you transfer waveform data, you must specify the data format, record
length, and waveform source.

Acquired waveform data uses 19 or more bits to represent each data point. The
number of bits used depends on the acquisition mode specified when you acquired
the data. Data acquired in SAMple or ENVElope mode uses 19 bits per waveform
data point. Data acquired in AVERage mode uses up to 24 bits per point.

The instrument can transfer waveform data in either ASCII or binary format. You
specify the format with the DATa:ENCdg command. The instrument uses signed,
4 byte integers and floating point values; it does not support unsigned values.

ASCII data is represented by signed integer or floating point values. An example
of an ASCII waveform data string may look like this:

:CURVE -509476864,-512163840,-511115264,-510918656,

-516161536,-484179968,-117112832,207093760,
322437120,351600640,409206784,468451328,
482934784,490668032,495517696,432668672,
482148352,483655680,493617152,495321088,
499843072,493420544,488964096,497221632,

f values that define a waveform. One data value usually represents

…

ASCII will produce more readable and more easily formatted output than that
produced by binary format. However, ASCII may require more bytes to send the
same values than it does with binary. This may reduce transmission speeds.

Binary data can be represented by signed integer or floating-point values. The
defined binary formats specify the order in which the bytes are transferred. The
following are the four binary formats:

RIBinary specifies signed integer data-point representation with the most
significant byte transferred first.

SRIBinary is the same as RIBinary except that the byte order is reversed;
the least significant byte is transferred first. This format is useful when
transferring data to IBM-compatible PCs.

FPBinary specifies floating-point data-point representation with the most
significant byte transferred first.

SFPBinary is the same as RFBinary except that the byte order is reversed;
the least significant byte is transferred first. This format is useful when
transferring data to IBM-compatible PCs.

DSA8300 Series Programmer Manual 2-43

Command Groups

Waveform Data and Record

Lengths

Wavefo

rm Data Locations

and Memory Allocation

You can trans f e
portion of the waveform or you can transfer the entire record. You can use the
DATa:STARt and DATa:STOP commands to specify the first and last data points
of the waveform record. The instrument supports record lengths of 50, 100, 250,
500, 1000, 2000, 4000, 8000, and 16000 samples. The maximum record length
for mag view waveforms is 4000 points.

When transferring data into the instrument, you must first specify the record
length of the destination waveform record. To specify the record length, use
the WFMInp
waveform record. For example , when you set DATa:STARt to 1, data points will
be stored starting with the first point in the record. The instrument will ignore the
value set by DATa:STOP when reading in data. It will stop reading in data when
there is no more data to read, or when it has reached the specified record length.

When transferring data from the instrument, you must specify the first and last
data points in the waveform record. Setting DATa:STARt to 1 and DATa:STOP to
the record length will always return the entire waveform.

The DATa:SOUrce and DATa:TIMebase commands specify the waveform source
and waveform timebase when transferring a waveform from the instrument. You
can only transfer one waveform at a time.

Waveforms sent to the instrument are always stored in one of the eight reference
memory locations. You use the DATa:DESTination command to specify a

erence memory location.

ref

r multiple points for each waveform record. You can transfer a

re:NR_Pt command. Next, specify the first data point within the

Waveform Preamble

Each waveform that you transfer has an associated waveform preamble that
contains information such as the horizontal scale, the vertical scale, and other

ttings in effect when the waveform was created. The values returned by the

se
WFMOutpre query commands are set by the previous curve query. Therefore,
to have a valid set of preamble and data, you must perform a CURVe? query
followed by a WFMOutpre? query. Refer to the individual WFMInpre and
WFMOutpre commands for more information.

2-44 DSA8300 Series Programmer Manual

Command Groups

Command

CURVe The command form transfers waveform data

DATa

DATa:DESTination Sets or returns the reference memory

DATa:ENCdg Sets or returns the format of the waveform

DATa:SOUrce Sets or returns the location of waveform data

TARt

DATa:S

DATa:STOP Sets or returns the ending data point in

WAVFrm? Returns W FMO u tpre? and CURVe? data

:TIMebase

DATa

WFMInpre? Returns the waveform formatting data

WFMInpre:BIT_Nr? Returns the number of bits (width) per

FMInpre:BN_Fmt

W

WFMInpre:BYT_Nr? Returns the byte width of the waveform to be

WFMInpre:BYT_Or Sets or returns which byte of binary waveform

Description

to the instrument (reference memory location
specified by DA

The query form transfers waveform data from
the instrument specified by the DATa:SOUrce
command

Sets the for
data that is transferred with the CURVe
command

Returns th
waveform data that is transferred with the
CURVe? command

location
the instrument

data

erred from the instrument

transf

Sets or
waveform transfer

waveform transfer

he waveform as specified by the

for t
DATA:SOUrce command

Sets or returns the DATa:SOUrce associated
timebase used to specify the location of the

eform data to be transferred from the

wav
instrument

(preamble) for the incoming waveform

aveform point for the waveform to be

w
transferred to the instrument

Sets o r returns the format of the binary or
ascii data encoding of the waveform to be
transferred to the instrument

transferred to the instrument

data is transmitted first during a waveform
data transfer to the instrument

Ta:DESTination)

mat and location of the waveform

e format and location of the

for s toring waveform data sent to

returns the starting data point in

DSA8300 Series Programmer Manual 2-45

Command Groups

Command

WFMInpre:ENCdg Sets or returns the type of encoding used for

WFMInpre:NR_Pt

WFMInpre:P

WFMInpre:WFMLabel

WFMInpre:XINcr

WFMInpre

WFMInpr

WFMInp

WFMInpre:XZEro

WFMI

WFM

WFMInpre:YSCALE Sets or returns the vertical unit scale factor

WFMInpre:YUNit

WFMInpre:YZEro

WFMOutpre? Returns the preamble for the outgoing

WFMOutpre:BIT_Nr? Returns the number of bits (width) per

WFMOutpre:BN_Fmt Sets or returns the format of the binary data

WFMOutpre:BYT_Nr? Returns the byte width for the waveform to

T_Fmt

:XMUlt

e:XOFf

re:XUNit

npre:YMUlt

Inpre:YOFf

Description

waveform data transferred with the CURVe
command

Sets or retur
waveform

Sets or returns the data point format of the
incoming waveform

Sets or r eturns the label for the incoming
waveform

Sets or re
of the incoming waveform

Sets or returns the horizontal scale factor
(horizontal units per division) of the incoming
wavefor

Sets or r
horizontal units of the incoming waveform

Sets or returns the horizontal (x-axis) units of
the incoming waveform

Sets or returns the horizontal (x-axis) origin
offse
the incoming waveform

Sets or returns the vertical scale in vertical
units per division of the incoming waveform

rned by the previous CURVe? command

retu

s or returns the vertical position of the

Set
incoming waveform in divisions

of the incoming waveform

Sets or returns the vertical (y-axis) units of

he incoming waveform

t

ets or returns the vertical offset voltage of

S
the incoming waveform

waveform

waveform point of the waveform to be
transferred from the instrument

encoding of the waveform to be transferred
from the instrument

be transferred from the instrument

ns the record length of the input

turns the interval between samples

m

eturns the horizontal position in

t(timeoffirst point in this instrument) of

2-46 DSA8300 Series Programmer Manual

Command Groups

Command

WFMOutpre:BYT_Or Sets or returns which byte of binary waveform

WFMOutpre:E

WFMOutpre:NR_Pt? Returns the number of points that were

WFMOutpre

WFMOutpre:WFId? Returns a descriptive string of the waveform

WFMOutp

WFMOutpre:XINcr? Returns the interval between samples of

WFMOu

WFMOutpre:XOFf?

WFMOutpre:XUNit? Returns the horizontal units of the waveform

Outpre:XZEro?

WFM

WFMOutpre:YMUlt? Returns the vertical scale factor in vertical

WFMOutpre:YOFf? Returns the vertical position of the waveform

WFMOutpre:YSCALE? Returns vertical unit scale factor of the

WFMOutpre:YUNit? Returns the vertical units of the waveform

WFMOutpre:YZEro? Returns the vertical offset of the waveform

NCdg

:PT_Fmt?

re:WFMLabel?

tpre:XMUlt?

Description

data is transmitted first during a waveform
data transfer

Sets or retur
waveform data transferred with the CURVe?
command

returned by

Returns th
waveform returned by the previous CURVe?
command

returned

Returns
transferred by the CURVe? command

the waveform transferred by the CURVe?
comman

Retur
waveform returned by the previous CURVe?
command

Returns the horizontal position in horizontal
units of the returned waveform

rned by the previous CURVe? command

retu

urns the time of first point (sample) of the

Ret
waveform returned by the previous CURVe?
command

its per division of the waveform returned

un
by the previous CURVe? command

returned by the previous CURVe? command

incoming waveform by the previous CURVe?
command

returned by the previous CURVe? command

returned by the previous CURVe? command

ns the type of encoding used for

the previous CURVe? command

e data point format of the

by the previous CURVe? command

the label for the previous waveform

d

ns the horizontal scale factor of the

DSA8300 Series Programmer Manual 2-47

Command Groups

2-48 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

ACQuire? (Query Only)

y only command that returns all the current acquisition parameters.

ACQUIRE:CURRENTCOUNT:ACQWFMS 0;HISTWFMS

.

Group

Syntax

Examples

This is a quer

Acquisition

ACQuire?

ACQUIRE? might return the following string for the current acquisition

parameters:

0;HISTHITS 0;MASKWFMS 0;MASKSAMPLES 0;MASKTHITS 0;MASKHITS1
0;MASKHITS2 0;MASKHITS3 0;MASKHITS4 0;MASKHITS5 0;MASKHITS6
0;MASKHITS7 0;MASKHITS8 0;:ACQUIRE:MODE SAMPLE;NUMAVG
16;SAVEFILE:SAVESCREEN "";SAVEWFM "";:ACQUIRE:STATE
1;STOPAFTER:MODE RUNSTOP;BELL 0;ACTION NONE;CONDITION
ACQWFMS;COUNT 1

ACQuire:CURRentcount:ACQWfms? (Query Only)

This query only command returns the current count value of acquired waveforms.
The target value of this count is set by the ACQuire:STOPAfter:COUNt command
(in conjunction with the ACQuire:STOPAfter:CONDition command). The
instrument then counts up to this value. When the count reaches (or exceeds) the
value, acquisition stops, and the specified StopAfter action is enabled.

Group

Syntax

Related Commands

Returns

Examples

DSA8300 Series Programmer Manual 2-49

Acquisition

ACQuire:CURRentcount:ACQWfms?

ACQuire:STOPAfter:COUNt, ACQuire:STOPAfter:CONDition

NR1 is the current count value of acquired waveforms.

ACQUIRE:CURRENTCOUNT:ACQWFMS? might return
ACQUIRE:CURRENTCOUNT:ACQWFMS 20, indicating that currently 20 waveforms

have been acquired.

Commands Listed in Alphabetical Order

ACQuire:CURR

Related Commands

Examples

entcount:HISTHits? (Query Only)

This query only command returns the current count value of histogram hits. The
target value of this count is set by the ACQuire:STOPAfter:COUNt command

ion with the ACQuire:STOPAfter:CONDition command). The

Group

Syntax

Returns

(in conjunct
instrument then counts up to this value. When the count reaches (or exceeds) this
value, acquisition stops, and the specified StopAfter action is enabled.

Acquisition

ACQuire:CURRentcount:HISTHits?

ACQuire:STOPAfter:COUNt, ACQuire:STOPAfter:CONDition

NR1 is the current count value of histogram hits.

ACQUIRE:CURRENTCOUNT:HISTHITS? might return
ACQUIRE:CURRENTCOUNT:HISTHITS 100, indicating that currently 100

histogram hits have been acquired.

ACQuire:CURRentcount:HISTWfms? (Query Only)

This query only command returns the current count value of waveforms
accumulated for histograms. The target value of this count is set by
the ACQuire:STOPAfter:COUNt command (in conjunction with the
ACQuire:STOPAfter:CONDition command). The instrument then counts up to
this value. When the count reaches (or exceeds) this value, acquisition stops, and
the specified StopAfter action is performed.

Group

Syntax

Related Commands

Returns

Acquisition

ACQuire:CURRentcount:HISTWfms?

ACQuire:STOPAfter:COUNt, ACQuire:STOPAfter:CONDition

NR1 is the current count value of histogram waveforms.

2-50 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

ACQuire:CUR

Related Commands

Examples

ACQUIRE:CURRE
ACQUIRE:CURRENTCOUNT:HISTWFMS 25, indicating that currently 25

waveforms have been acquired in the histogram.

NTCOUNT:HISTWFMS?

Rentcount:MASKHits<x>? (Query Only)

This query only command returns the current count value of hits in the specified
mask polygon, which can be 1 through 8. The target value of this count is

CQuire:STOPAfter:COUNt command (in conjunction with the

Group

Syntax

set by the A
ACQuire:STOPAfter:CONDition command). The instrument then counts up to
this value. When the count reaches (or exceeds) this value, acquisition stops, and
the specified StopAfter action is enabled.

Acquisition

ACQuire:CURRentcount:MASKHits<x>?

ACQuire:STOPAfter:COUNt, ACQuire:STOPAfter:CONDition

might return

Returns

Examples

NR1 is the current count value of hits for the specified mask polygon, which can

be 1 through 8.

ACQUIRE:CURRENTCOUNT:MASKHITS4 might return
ACQUIRE:CURRENTCOUNT:MASKHITS4 300, indicating that currently 300 mask

hits have been acquired in mask 4.

ACQuire:CURRentcount:MASKSamples? (Query Only)

This query only command returns the current count value of mask samples. The
target value of this count is set by the ACQuire:STOPAfter:COUNt command
(in conjunction with the ACQuire:STOPAfter:CONDition command). The
instrument then counts up to this value. When the count reaches (or exceeds) this
value, acquisition stops, and the specified StopAfter action is performed.

Group

Syntax

Acquisition

ACQuire:CURRentcount:MASKSamples?

Related Commands

DSA8300 Series Programmer Manual 2-51

ACQuire:STOPAfter:COUNt, ACQuire:STOPAfter:CONDition

Commands Listed in Alphabetical Order

Returns

Examples

NR1 is the curre

ACQUIRE:CURRENTCOUNT:MASKSAMPLES? might return
ACQUIRE:CURRENTCOUNT:MASKSAMPLES 75, indicating that

currently 75 mask samples have been acquired for mask testing.

nt count value of mask samples accumulated for mask testing.

ACQuire:CURRentcount:MASKTHits? (Query Only)

This query only command returns the current total count value of mask hits. The
target value of this count is set by the ACQuire:STOPAfter:COUNt command
(in conjunction with the ACQuire:STOPAfter:CONDition command). The
instrument then counts up to this value. When the count reaches (or exceeds) this
value, acquisition stops, and the specified StopAfter action is performed.

Group

Syntax

Acquisition

ACQuire:CURRentcount:MASKTHits?

Related Commands

Returns

Examples

ACQuire:STOPAfter:COUNt, ACQuire:STOPAfter:CONDition

NR1 is the current count value of mask hits.

ACQUIRE:CURRENTCOUNT:MASKTHITS? might return
ACQUIRE:CURRENTCOUNT:MASKTHITS 300, indicating that currently 300 mask

hits have been acquired.

ACQuire:CURRentcount:MASKWfms? (Query Only)

This query only command returns the current count value of mask waveforms.
The target value of this count is set by the ACQuire:STOPAfter:COUNt command
(in conjunction with the ACQuire:STOPAfter:CONDition command). The
instrument then counts up to this value. When the count reaches (or exceeds) this
value, acquisition stops, and the specified StopAfter action is performed.

Group

Acquisition

Syntax

2-52 DSA8300 Series Programmer Manual

ACQuire:CURRentcount:MASKWfms?

Commands Listed in Alphabetical Order

Related Commands

Returns

Examples

ACQuire:STOPA

NR1 is the current count value of waveforms accumulated for mask testing.

ACQUIRE:CURRENTCOUNT:MASKWFMS? might return
ACQUIRE:CURRENTCOUNT:MASKWFMS 25, indicating that currently 25

waveforms have been acquired for mask testing.

fter:COUNt, ACQuire:STOPAfter:CONDition

ACQuire:DATA:CLEar (No Query Form)

This command (no query form) causes an acquisition reset and clears all acquired
data, clears the display, and, if active, resets FrameScan. When a clear data
occurs, it has the following effects:

Sample-mode waveform. The current waveform data is replaced by the
waveform data of the next acquisition cycle when it is available.

Average-mode waveform. The average algorithm mode resets such that the
next acquisition w ill be a straight-through copy.

Envelope-mode waveform. The envelope algorithm mode resets such that the
next acquisition w ill be a straight-through copy.

Group

Syntax

Examples

Waveform database. The contents of all databases are cleared (reset to zero)
immediately.

Histogram data and statistics. The data and all statistics will be cleared
immediately.

Mask counts and statistics. Mask counts and all statistics will be cleared
immediately.

Acquisition status. The acquisition waveform count or StopAfter condition is
reset and target counts are reloaded.

Counts. Resets all counts, including number of acquired waveforms,
acquisition and math average counts, conditional stop counts, and FrameScan
counts (if any of these are active).

Measurement statistics. Measurement statistics are reset.

Acquisition

ACQuire:DATA:CLEar

ACQUIRE:DATA:CLEAR causes an acquisition reset and clears all acquired data.

DSA8300 Series Programmer Manual 2-53

Commands Listed in Alphabetical Order

ACQuire:MODe

This command sets or queries the acquisition mode of the instrument, which
determines how the final value of the acquisition interval is generated from the
many data sam
channel wa veforms that it acquires. Sending this command is equivalent to
selecting the Acquisition Mode in the Acquisition Setup dialog box.

Normally, the instrument takes one sample per trigger and builds a channel
waveform over many successive triggers. If acquiring continues, the instrument
writes over the acquired waveform with each newly acquired waveform from the
same channel. You can modify this behavior by setting the instrument to use one
of the three, mutually exclusive acquisition modes:

Sample. Use Sample mode to see the signal in its purest form with no post
processing. This is the default mode.

Average. Use Average mode to reduce the apparent noise in the signal to
reveal fundamental waveform behavior.

Envelope. Use Envelope mode when it's important to see the variation of
extremes in a waveform over time.

ples. The instrument applies the specified mode globally to all

Group

Syntax

Related Commands

Acquisition

ACQuire:MODe { SAMple | AVERage | ENVElope }
ACQuire:MODe?

ACQuire:NUMAVg

2-54 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

Arguments

Examples

SAMple specifie

simply the sampled value that was taken during the acquisition interval.
There is no post processing of acquired samples; the instrument overwrites
waveforms at each new acquisition cycle.
mode.

AVERage specifies averaging mode, in which the resulting waveform shows

anaverageofSAMpledatapointsfrom several consecutive waveform
acquisitions. The instrument processes the number of waveforms you
specify in
exponential a verage of the input signal. The number of waveform acquisitions
that go into making up the average waveform is set or queried using the
ACQuire:NUMAVg command.

ENVElope specifies envelope mode, in which the instrument continuously, as

subsequent waveforms are acquired, retains the running minimum (Min) and
maximum (Max) values in adjacent sample intervals, creating an envelope of
all waveforms acquired for that channel.

ACQUIRE:MODE ENVELOPE sets the acquisition mode to display a waveform that

is an envelope of many individual waveform acquisitions.

ACQUIRE:MODE? might return ACQUIRE:MODE AVERAGE, indicating that

the displayed waveform is the average of the specified number of waveform
acquisitions.

s sample mode, in which the displayed data point value is

SAMple is the default acquisition

to the acquired waveform, creating a running back-weighted

ACQuire:NUMAVg

Group

Syntax

Related Commands

Arguments

This command sets or queries the number of waveform acquisitions that make up
an averaged waveform. Sending this command is equivalent to s
of samples in the Acquisition Mode section of the Acquisition Setup dialog box
when Average is checked for the Acquisition Mode. Use the ACQuire:MODe
command to enable the Average mode.

Acquisition

ACQuire:NUMAVg <NR1>
ACQuire:NUMAVg?

ACQuire:MODe

NR1 is the number of consecutive waveform acquisitions (from 2 to 4,096) used

for averaging.

etting the number

DSA8300 Series Programmer Manual 2-55

Commands Listed in Alphabetical Order

Examples

ACQUIRE:NUMAV

of combining 10 separately acquired waveforms.

ACQUIRE:NUMAVG? might return ACQUIRE:NUMAVG 75, indicating that there are

75 acquisitions specified for averaging.

ACQuire:SAVEFile:SAVEScreen

This command sets or queries the file to which a screen is saved at the completion
of a StopAfter condition (when the StopAfter action is set to SAVEScreen). See
the ACQuire:STOPAfter:ACTion command. The s creen is saved in the specified
file in .BMP format. This is equivalent to selecting Print Screen to File in the Stop
Action section of the Acquisition Setup dialog box and entering a file name.

G10

specifies that an averaged waveform will show the result

Group

Syntax

Related Commands

Arguments

Examples

Acquisition

ACQuire:SAVEFile:SAVEScreen <Qstring>
ACQuire:SAVEFile:SAVEScreen?

ACQuire:STOPAfter:ACTion, ACQuire:STOPAfter:CONDition,
ACQuire:STOPAfter:MODe

<Qstring> defines the file name and path. Input the file path using the form

<drive>/<dir>/<filename>. The <drive> and one or more <dir> arguments are
optional. If you do not specify them, the instrument will copy the file into the
current directory. The <filename> can be a Windows long file name. Do not
use wild card c haracters.

ACQUIRE:SAVEFILE:SAVESCREEN "Wavetest.bmp" specifies the file

Wavetest.bmp (in the current directory) to which the screen will be saved after a
StopAfter SAVEScreen condition is met.

ACQUIRE:SAVEFILE:SAVESCREEN? might return
ACQUIRE:SAVEFILE:SAVESCREEN "TESTFILE.BMP", indicating that the

screen will be saved in TESTFILE.BMP in the current directory when the
StopAfter action is enabled.

ACQuire:SAVEFile:SAVEWfm

This command sets or queries the file to which waveform data is saved at
the completion of a StopAfter condition (when the StopAfter action is set to
SAVEWaveform). See the ACQuire:STOPAfter:ACTion command. This is
equivalent to selecting Save All Waveforms in the Stop Action section of the

2-56 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

Group

Syntax

Related Commands

Arguments

Acquisition Se
base file name and path used when multiple waveforms are saved. Each saved
waveform has the base file name with a unique index number appended to it to
prevent overwriting of the files.

Acquisition

ACQuire:SAVEFile:SAVEWfm <Qstring>
ACQuire:SAVEFile:SAVEWfm?

ACQuire:STOPAfter:ACTion, ACQuire:STOPAfter:CONDition,
ACQuire:STOPAfter:MODe

<QSTRING> defines the base file name and path. Input the file path using the form

<drive>/<dir>/<filename>. The <drive> and one or more <dir> arguments are
optional. If you do not specify them, the instrument will copy the file into the
current directory. The <filename> can be a Windows long file name. Do not use
wild card characters. An index number is attached to the base filename each time
this command is sent so that the fi le is not overwritten. For example, a file with
thebasenameWave.docwillbesavedasWave1.docthefirst time, Wave2.doc the
second time, and so on.

tup dialog b ox and entering a file name. This command sets the

Examples

ACQuire:STATE

Group

Syntax

ACQUIRE:SAVEFILE:SAVEWFM "Wave.doc" specifies the file Wave1.doc

(in the current directory) to which the screen will be saved after a StopAfter
SAVEWfm condition is met.

ACQUIRE:SAVEFILE:SAVEWFM? might return ACQUIRE:SAVEFILE:SAVEWFM
"WAVETST.DOC"

WAVETST.DOC in the current directory when the StopAfter action is enabled.

This command starts or stops acquisitions or queries whether the acquisition
is running or stopped. Sending this command is equivalent to pressing
the front-panel RUN/STOP button. The ACQuire:STOPAfter:MODe and

ACQuire:STOPAfter:CONDition commands may cause other signal events to

also stop acquisition.

Acquisition

ACQuire:STATE { OFF | ON | RUN | STOP | <NR1> }
ACQuire:STATE?

, indicating that the waveform data will be saved in

DSA8300 Series Programmer Manual 2-57

Commands Listed in Alphabetical Order

Related Commands

Arguments

Examples

ACQuire:STOPA

OFF stops acquisitions.

STOP stops acquisitions.

ON starts acquisitions.

RUN starts acquisitions.

NR1 set to 0 stops acquisitions; any other value starts acquisitions.

ACQUIRE:STATE RUN starts acquisition of waveform data.

ACQUIRE:STATE? might return ACQUIRE:STATE 1, indicating that the

acquisition system is running.

NOTE. A query always returns a 0 or 1.

ACQuire:STOPAfter? (Query Only)

This query only command returns all StopAfter parameters.

fter:MODe, ACQuire:STOPAfter:CONDition

Group

Syntax

Examples

Acquisition

ACQuire:STOPAfter?

ACQUIRE:STOPAFTER? might return ACQUIRE:STOPAFTER:MODE
RUNSTOP;BELL 0;ACTION NONE;C ONDITION ACQWFMS;COUNT 1

ACQuire:STOPAfter:ACTion

This command sets or queries the action that the instrument performs after the
acquisition is stopped when reading a conditional state. This is equivalent to
making a Stop Action selection in the Acquisition Setu

Group

Syntax

Acquisition

ACQuire:STOPAfter:ACTion { N ONe | SAVEScreen | PRINTScreen
| SAVEWaveform }
ACQuire:STOPAfter:AC

.

p dialog box.

Tion?

2-58 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

Related Commands

Arguments

Examples

ACQuire:SAVEF

NONe specifies to take no action when the stop after condition is met. This is

ile:SAVEScreen, ACQuire:SAVEFile:SAVEWfm

the default.

SAVEScreen specifies that on acquisition stop the file named by the

ACQuire:SAVEFile:SAVEScreen command will be created if it does not
exist or overwritten if does. The resultant file will contain a bitmap image of
the display.

PRINTScreen specifies that on acquisition stop a bitmap image of the

application is sent to the default printer.

SAVEWaveform specifies that on acquisition stop all waveforms are saved in

the files specified by the ACQuire:SAVEFile:SAVEWfm command.

ACQUIRE:STOPAFTER:ACTION PRINTSCREEN sets the instrument to send a

bitmap image of the application to the printer when the stop after condition is met.

ACQUIRE:STOPAFTER:ACTION? might return ACQUIRE:STOPAFTER:ACTION

, indicating that no action is taken when the stop after condition is met.

NONE

ACQuire:STOPAfter:BELL

This command sets or queries whether to sound the bell after the acquisition is
comple
of the Acquisition Setup dialog box.

Group

Syntax

Arguments

Examples

Acqui

ACQuire:STOPAfter:BELL { ON | OFF | NR1 }
ACQuire:STOPAfter:BELL?

ACQUIRE:STOPAFTER:BELL ON turns on the Stop After Bell feature.

ACQUIRE:STOPAFTER:BELL? might return ACQuire:STOPAfter:BELL 1,

indicating that the Stop After Bell feature is on.

te. This is equivalent to checking Ring Bell in the Stop Action section

sition

ON turns on the bell.

0FF turns off the bell.

NR1 set to 0 turns off the bell; any other value turns on the bell.

NOTE. A query always returns a 0 or 1.

DSA8300 Series Programmer Manual 2-59

Commands Listed in Alphabetical Order

NOTE. The DSA83

connect a speaker to the audio Line Output jack on the back of the instrument.

ACQuire:STOPAfter:CONDition

This command sets or queries the StopAfter condition. The StopAfter condition
qualifies a s
can be active at a given time. Each StopAfter condition identifies, directly or
indirectly, a specific data element or operation such that all mutually exclusive
conditions are unique and unambiguous. This command allows you to specify
the condition on which to stop acquiring. The condition is valid when the
ACQuire:STOPAfter:MODE is set to CONDition. This is equivalent to checking
the Condi
box and selecting a condition.

NOTE. You must have the associated feature enabled before you can

set the StopAfter condition. For example, you must turn on histograms
(HIStogram:ENABle) before you can set the HISTHits StopAfter condition.

Group

Acquisition

00 does not have an internal speaker. To hear a "bell" on stop,

top condition for the acquisition system. Only one StopAfter condition

tion control in the Stop After section o f the Acquisition Setup dialog

Syntax

Related Commands

Arguments

ACQuire:STOPAfter:CONDition { ACQWfms | HISTWaveform
| HISTHits | MASKWaveform | MASKSample | MASK<x>Hits |
MASKTOTalhit | FRAMecycle | AVGComp }
ACQuire:STOPAfter:CONDition?

ACQuire:STOPAfter:COUNt, ACQuire:STOPAfter:MODe

ACQWfms sets the instrument to stop acquiring after some specified number of

raw acquisition cycles. This setting tells the instrument to count the number
of Main Timebase sweeps (Mag sweeps are not counted independently) and
stop acquisition after the specified number of acquisitions has been reached.
Use the ACQuire:STOPAfter:COUNt command to set the target number of
waveforms.

HISTWaveform sets the instrument to stop acquisition after a

specified number of Histogram source waveforms is acquired. Use the
ACQuire:STOPAfter:COUNt command to set the specified number of
waveforms.

2-60 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

HISTHits sets t

he instrument to stop acquisition after it acquires a specified
number of valid hits (that is, non-null samples) in the histogram region. This
is a greater than or equal to condition because only complete records are
processed. Therefore, the number of actual hits will not necessarily match
your requested number of hits; the acquisition will stop when the number
of hits is greater than or equal to the number of specified hits. Use the
ACQuire:ST

MASKWaveform sets the instrument to stop acquisition after a specified

number of t

OPAfter:COUNt command to set the specified number of hits.

he Mask source waveforms are acquired. U se the
ACQuire:STOPAfter:COUNt command to set the specified number of
waveforms.

MASKSample sets the instrument to stop acquisition after a greater than or

equal to number of valid (that is, non-null) waveform samples are acquired of
the Mask source waveform. Use the ACQuire:STOPAfter:COUNt command
to set the specified number of waveform samples.

MASK<x>Hits sets the instrument to stop acquisition after a specified number

of mask hits occur in mask number < x>, which can be 1 through 8. For the
same reasons as HISTHits argument, this is also a g reater than or equal to

tion. Use the ACQuire:STOPAfter:COUNt command to set the specified

condi
number of hits.

MASK

TOTalhit

sets the instrument to stop acquisition after a specified
number of total mask hits occurs in all masks combined. For the same reasons
as the HISTHits argument, this is also a greater than or equal to condition.
Use the ACQuire:STOPAfter:COUNt command to set the specified total
number of hits.

Examples

FRAMecycle sets the instrument to stop acquisition after it has acquired

thenumberofbitsspecified by the HORizontal:FRAMescan:SCANBits
command.

AVGComp sets the instrument to stop acquisition after the number of

waveforms specified by the ACQuire:NUMAVg command have been
acquired and averaged.

ACQUIRE:STOPAFTER:CONDITION HISTHits sets the instrument to stop

acquisition after it acquires the specified number of valid hits in the histogram
region.

ACQUIRE:STOPAFTER:CONDITION? might return
ACQuire:STOPAfter:CONDition MASK3HITS, indicating that the acquisition

will be stopped after the hits in mask 3 are equal to or greater than the specified
number of hits.

DSA8300 Series Programmer Manual 2-61

Commands Listed in Alphabetical Order

ACQuire:STOP

Related Commands

After:COUNt

This command sets or queries the target StopAfter count for the condition
specified by the ACQuire:STOPAfter:CONDition command. The current count
for the condi
are s topped and a StopAfter action is enabled. The state of the numeric
StopAfter count for each condition is kept individually so that you do not need
to re-enter a count when switching between conditions. Use the appropriate
ACQuire:CURRentcount command to get the current count for a condition (see
Related Commands below).

Group

Syntax

Acquisition

ACQuire:STOPAfter:COUNt <NR1>
ACQuire:STOPAfter:COUNt?

ACQuire:STOPAfter:MODe, ACQuire:STOPAfter:CONDition,
ACQuire:CURRentcount:ACQWfms?, ACQuire:CURRentcount:HISTWfms?,
ACQuire:CURRentcount:HISTHits?, ACQuire:CURRentcount:MASKWfms?,
ACQuire:CURRentcount:MASKHits<x>?, ACQuire:CURRentcount:
MASKSamples?

tion must be equal to or greater than this value before acquisitions

Arguments

Examples

NR1 is the count value that must be reached (or exceeded) before the acquisitions

stop and StopAfter action can occur.

ACQUIRE:STOPAFTER:COUNT 12 sets the StopAfter count for the specified

condition to 12.

ACQUIRE:STOPAFTER:COUNT? might return AC Quire:STOPAfter:COUNt 5,

indicating that the total count for the specified condition is 5.

ACQuire:STOPAfter:MODe

This command tells the instrument when to stop taking acquisitions. The
query form of this command returns the StopAfter mode. This command is the
equivalent of checking Run/Stop or Condition in the Stop After section of the
Acquisition Setup dialog box. (The ACQuire:STATE command can also be used
to start or stop acquisitions.)

Group

Acqui

sition

2-62 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

Syntax

Related Commands

Arguments

Examples

ACQuire:STOPA
ACQuire:STOPAfter:MODe?

ACQuire:STOPAfter:CONDition, ACQuire:STATE

RUNSTop specifies that the run and stop state is determined by the front-panel

RUN/STOP controls.

CONDition specifies that the run and stop state of the system is determined

by a set a qualifiers specified by the StopAfter Condition. These sub-states
are further described in the ACQuire:STOPAfter:
instrument c
Run/Stop button or by sending the ACQuire:STATE command.)

ACQUIRE:STOPAFTER:MODE RUNSTOP sets the instrument to run or stop

acquisitions when the user presses the front-panel RUN/STOP button or the user
sends the ACQuire:STATE command.

ACQUIRE:STOPAFTER:MODE? might return ACQUIRE:STOPAFTER:MODE
CONDITION

a set of qualifiers specified by the StopAfter condition.

fter:MODe { RUNSTop | CONDition }

CONDition section. (The

an still be stopped unconditionally by pressing the front-panel

, indicating that the run and stop state of the system is determined by

ALLEv? (Query Only)

Group

Syntax

Related Commands

Returns

This query only command causes the instrument to return all events and their
messages and removes the returned events from the Event Queue. The messages
are separated by commas. Use the *ESR? query to enable the events to be
returned. For a complete discussion of the use of these registers, see the topics
in Status and Events. This command is similar to repeatedly sending *EVMsg?
queries to the instrument.

and Error

Status

ALLEv?

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

The event code and message in the following format:

<Event Code>,<QString>[<Event
Code>,<QString>]<QString>::=<Message>;[<Command>]

DSA8300 Series Programmer Manual 2-63

Commands Listed in Alphabetical Order

where <Command

> is the command that caused the error and may be returned
when a command error is detected by the instrument. As much of the command
will be returned as possible without exceeding the 60-character limit of the
<Message> and <Command> strings combined. The command string is right
justified.

Examples

ALLEV? might return the string :ALLEV 2225,"MEASUREMENT ERROR, NO
WAVEFORM TO MEASURE;",420,"Q UERY UNTERMINATED;"

APPlication:ACTivate (No Query Form)

This command (no query form) is used to launch the optional s
applications. The application must be installed and activated with a key code. (A
key code is not necessary if the application is within a free trial period).

Group

Syntax

Miscellaneous

APPlication:ACTivate {"80SJNB" | "80SJARB" | "CRXXX Control"
| "IConnect" | "IConnect and MeasureXtra ctor" | "IConnect
and MeasureXtractor Evaluation" | "IConnect S-Parameters and
Z-line" | "IConnect S-parameter Wizard"}

.

oftware

Arguments

80SJNB is the optional 80SJNB Advanced Jitter, Noise, and BER Analysis

software for c omprehensive jitter, noise, and bit error ratio (BER) analysis for
serial data signal impairment characterization.

80SJARB is the optional 80SJARB basic jitter measurement tool, capable of

measuring jitter on random or repetitive waveforms.

CRXXX Control is the optional BERTScope Clock Recovery Instrument Control

software. This control software works with 80A07, CR125A, CR175A and
CR286A clock recovery instruments connected to the DSA8300 via USB

IConnect is the optional IConnect® software for measurement-based

.

performance evaluation of gigabit interconnect links and devices, including
signal integrity analysis, impedance, S-parameter, and eye-diagram tests and
fault isolation.

IConnect and MeasureXtractor is the optional software for

measurement-based performance evaluation of gigabit interconnect links and
devices, including signal integrity analysis, impedance, S-parameter, and
eye-diagram tests and fault isolation; includes the ability to extract "black box"
interconnect models of passive interconnects.

IConnect and MeasureXtractor Evaluation is trial version of the

IConnect and MeasureXtractor software application.

2-64 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

IConnect S-par

measurement-based performance evaluation of gigabit interconnect links and
devices, including signa l integrity analysis, impedance, S-parameters, and fault
isolation.

IConnect S-parameters Wizard is the optional S-parameter

“mini-application” that guides you through setup, calibration (including channel
deskew) and acquisition of S-parameters, and automatically generates Touchstone
files for one or more DUTs.

Examples

APPLICATION:ACTIVATE 80SJNB launches the 80SJNB software application.

AUTOSet (No Query Form)

This command (no query form) causes the instrument to adjust its vertical,
horizontal, and trigger controls to provide a stable display of the selected
waveform. Sending this command is equivalent to pressing the front-panel
AUTOSE

NOTE. If the currently selected waveform is a mask source, the instrument runs a

mask autoset.

T button.

ameters and Z-line

is the optional software for

Group

Syntax

Related Commands

Arguments

Examples

If the TRIGger:SOUrce is set to EXTPrescale or C1CLKRec or C3CLKRec and
TRIGger:MODe is set to PATtern, the instrument runs a pattern sync autoset.

If the currently selected waveform is a channel with a TDR step enabled, the
instrument runs a TDR autoset.

Miscellaneous

AUTOSet EXECute

AUTOSet:TYPE

EXECUTE autosets the currently selected waveform.

AUTOSET EXECUTE performs an autoset on the currently selected waveform.

DSA8300 Series Programmer Manual 2-65

Commands Listed in Alphabetical Order

AUTOSet:HORi

Related Commands

Arguments

zontal

Group

Syntax

This command sets or queries whether an autoset should perform the horizontal
autoset portion when Autoset is executed.

Horizontal

AUTOSet:HORizontal { ON | OFF | NR1 }
AUTOSet:HORizontal?

AUTOSet

ON enables the horizontal AutoSet options.

OFF disables the horizontal AutoSet options.

NR1 set to 0 disables the horizontal AutoSet options; any other value enables

the horizontal AutoSet options.

Examples

AUTOSET:HORIZONTAL ON enables the horizontal autoset options.

AUTOSET:HORIZONTAL? might return AUTOSET:HORIZONTAL 0, indicating that

horizontal autoset options are disabled.

NOTE. A query always returns a 0 or 1.

AUTOSet:STOP (No Query Form)

This command (no query form) aborts an autoset that was initiated with the
AUTOSet command.

Group

Syntax

Examples

Miscellaneous

AUTOSet:STOP

AUTOSET:STOP abor

ts the autoset.

2-66 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

AUTOSet:TDR:

Related Commands

Arguments

INCident

Group

Syntax

This command sets or queries the option to display the TDR incident edge
on-screen when performing a TDR Autoset. If the Display Incident Edge is on,
the incident
If the Display Incident Edge is off, the incident edge is placed one horizontal
division off the left edge of the screen.

TDR

AUTOSet:TDR:INCident { ON | OFF | NR1 }
AUTOSet:TDR:INCident?

AUTOSet:TYPE, AUTOSet

ON enables the TDR incident edge autoset option.

OFF disables the TDR incident edge autoset option.

NR1 set to 0 disables the TDR incident edge autoset option; any other value

enables the TDR incident edge autoset option.

edge is placed at the one-half horizontal division (from left edge).

Examples

AUTOSet:TRIGger

Group

Syntax

AUTOSET:TDR:INCIDENT ON turns on the Incident Edge option for the TDR

autoset.

AUTOSET:TDR:INCIDENT? might return :AUTOSET:TDR:INCIDENT 1,

indicating that the TDR incident edge is set to be displayed on-screen when
performing a TDR autoset.

NOTE. A query always returns a 0 or 1.

This command sets or queries whether an autoset should perform the trigger
autoset portion when Autoset is executed.

Trigger

AUTOSet:TRIGger { ON | OFF | NR1 }
AUTOSet:TRIGger?

DSA8300 Series Programmer Manual 2-67

Commands Listed in Alphabetical Order

Related Commands

Arguments

Examples

AUTOSet:TYPE

AUTOSet

ON enables the trigger AutoSet options.

OFF disables the trigger AutoSet options.

NR1 set to 0 disables the trigger AutoSet options; any other value enables

the trigger AutoSet options.

AUTOSET:TRIGGER ON enables the trigger autoset options.

AUTOSET:

autoset options are disabled.

NOTE. A query always returns a 0 or 1.

This command sets or queries the default mode used by the AUTOSet command to
perfo
you can bias the autoset operation for display of either a waveform edge, period,
eye, or TDR edge in the graticule. Sending this command is equivalent to
selecting a mode in the Autoset Properties dialog box.

TRIGGER?

rm nonmask and nonTDR AUTOSet operations. Using the TYPE argument,

might return AUTOSET:TRIGGER 0, indicating that trigger

Group

Syntax

Related Commands

NOTE. When performing MASK:AUTOSet operations, the currently pre-defined

mask standard (selected with the MASK:STANDARD command) drives Autoset

ecution, not the AUTOSET:TYPE command setting. However, when using a

ex
user-defined mask, you still might want to use the AUTOSet and AUTOSet:TYPE
command, since the MASK:AUTOSET command is unable to obtain autoset
parameters from a user-defined mask standard.

Miscellaneous

AUTOSet:TYPE { EDGe | PERIod | EYE | RZ | TDR }
AUTOSet:TYPE?

AUTOSet, AUTOSet:TDR:INCident, AUTOSet:VERTical, AUTOSet:TRIGger,
AUTOSet:HORizontal

2-68 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

Arguments

EDGE sets subse

quent autoset commands to configure the instrument to
display a rising edge of the signal connected to the currently selected channel
in the center 20% of the graticule.

PERIod sets subsequent autoset commands to configure the instrument to

display 2 to 3 periods of the signal connected to the currently selected channel
centered in the graticule.

EYE sets subsequent autoset commands to configure the instrument to display

one bit (two eye crossings) horizontally centered across approximately 70%
of the graticule (7 divisions) and vertically centered across approximately
60% of the graticule (6 divisions). Use the Eye argument for N

RZ sets subsequent autoset commands to configure the instrument to display

RZ waveforms.

one bit (two rising edges) horizontally centered across approximately 60%
of the gr

aticule (6 divisions) and vertically centered across approximately

50% of the graticule (5 divisions).

TDR set

s subsequent autoset commands to configure the instrument to display
the first significant reflection at the third horizontal division. If the Display
Incident Edge option is on, the incident edge is placed at the one-half
horizontal division (from left edge). If the Display Incident Edge is off,
the incident edge is placed one horizontal division off the left edge of the
screen. If no significant reflections are located, the incident edge is placed

e one-half horizontal division (from left edge) regardless of the Display

at th
Incident Edge setting.

NOTE. If the Trigger Source is a clock and the trigger Mode is set to Pattern, an

Edge or Period autoset will attempt to display 20 bit periods.

Examples

AUTOSET:TYPE EDGE sets the default Autoset mode to EDGE.

AUTOSET:TYPE? might return AUTOSET:TYPE RZ, indicating that the default

AutosetmodeisRZ.

AUTOSet:UNDO (No Query Form)

This command (no query form) returns the parameters changed by an AUTOSet
command to their previous states. This command is invalidated the first time you
modify any instrument state parameter.

Group

Syntax

Miscellaneous

AUTOSet:UNDO

DSA8300 Series Programmer Manual 2-69

Commands Listed in Alphabetical Order

Related Commands

Examples

AUTOSet:VERTical

Group

Syntax

Related Commands

Arguments

AUTOSet

AUTOSET:UNDO returns the parameters to their previous states,

This command sets or queries whether an autoset should perform the vertical
autoset portion when Autoset is executed.

Vertical

AUTOSet:VERTical { ON | OFF | NR1 }
AUTOSet:VERTical?

AUTOSet

ON enables the vertical AutoSet options.

Examples

BUSY? (Query Only)

Group

OFF disables the vertical AutoSet options.

NR1 set to 0 disables the vertical AutoSet options; any other value enables

the vertical AutoSet options.

AUTOSET:VERTICAL ON

This command enables the vertical autoset options.

AUTOSET:VERTICAL? might return AUTOSET:VERTICAL 0, indicating that

vertical autoset options a

NOTE. A query always returns a 0 or 1.

This is a query only command that returns the s tatus of the instrument. This
commandallowsyoutosy
application program. See Synchronization Methods for more detailed information.

Status and Error

re disabled.

nchronize the operation of the instrument with your

2-70 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

Syntax

Related Commands

Returns

BUSY?

*OPC, *WAI

<NR1>

If 0 is returned, it means that the instrument is not busy processing a command
whose execution time is extensive. These commands are listed in the table below.

If 1 is returned, it means that the instrument is busy processing one of the
commands listed in the table below.

Table 2-18: Commands that affect BUSY? response

Operation Command

Automatic instrument
adjustment

Internal self
compensation

Conditional ACQuire:STATE ON or

Hardcopy output

AUTOSet EX ECute

COMPensate:ALLModules

COMPensate:CH<x>

COMPensate:DARKLev:CH<x>

COMPensate:MAInframe

COMPensate:OPTGAIN:CH<x>

ACQuire:STATE RUN

(when ACQuire:STOPAfter:MODe is set to CONDition)

HARDCopy STARt

Examples

BUSY? might return 1, indicating that the instrument is busy.

CALibrate:DATE:CH<x>? (Query Only)

This query only command returns the date and time of the last calibration
information update for the sampling module channel.

Group

Syntax

Examples

DSA8300 Series Programmer Manual 2-71

Calibration

CALibrate:DATE:CH<x>?

CALIBRATE:DATE:CH1? might return CALIBRATE:DATE:CH1 15 JAN 00

, indicating that the last calibration update for the CH1 sampling module

16:25

was done on January 15, 2000, at 4:25 PM.

Commands Listed in Alphabetical Order

CALibrate:DA

TE:MAInframe? (Query Only)

This query only command returns the date and time of the last calibration
information update for the mainframe.

Group

Syntax

Examples

Calibration

CALibrate:DATE:MAInframe?

CALIBRATE:DATE:MAINFRAME? might return CALIBRATE:DATE:MAINFRAME
15 JAN 00 16:25

was done on January 15, 2000, at 4:25 PM.

CALibrate:DCCALibrator

This command sets or queries the value of the DC Calibrator voltage.

Group

Calibration

, indicating that the last calibration update for the mainframe

Syntax

Arguments

Examples

CALibrate:DCCAL
CALibrate:DCCALibrator?

NR2 is the value to which you want to set the DC Calibrator voltage. The range

for this value is from -1.25 VDC through +1.25 VDC.

CALIBRATE:DCCALIBRATOR 0.5 sets the DC Calibrator voltage to 0.5 V.

CALIBRATE:DCCALIBRATOR? might return CALIBRATE:DCCALIBRATOR

5.00000000000E-001

ibrator <NR2>

, indicating that the DC Calibrator voltage is set to 0.5 V.

CALibrate:HOSTinfo:CH<x>? (Query Only)

This query only command returns the mainframe channel, model number, and
serial number in which the sampling module channel was located during the last
calibration information update.

Group

Syntax

Calibration

CALibrate:HOSTinfo:CH<x>?

2-72 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

Examples

CALIBRATE:HOS
"DSA8300,B010235,CH4"

channel 2 was installed in channel 4 of the mainframe, serial number B010235,
during the last calibration information update.

TINFO:CH2

CALibrate:LOCK:STATus? (Query Only)

This is a query only command that returns the status of the calibration protection
mode.

Group

Syntax

Examples

Calibration

CALibrate:LOCK:STATus?

CALIBRATE:LOCK:STATUS? might return CALIBRATE:LOCK:STATUS 1,

indicating that the calibration information is protected and cannot be updated.

CALibrate:STATus:CH<x>? (Query Only)

might return CALIBRATE:HOSTINFO:CH2

, indicating that the sampling module currently in

This is a query only command that returns the current calibration status for the
sampling module channel.

Group

Syntax

Returns

Examples

Calibration

CALibrate:STATus:CH<x>?

May return PASS, DEFAULTS, or WARMUP.

CALIBRATE:STATUS:CH1? might return CALIBRATE:STATUS:CH1 PASS,

indicating that the calibration status of the sampling module in channel 1 is PASS.

CALibrate:STATus:MAInframe? (Query Only)

This is a query only command that returns the current calibration status for the
mainframe.

Group

Calibration

DSA8300 Series Programmer Manual 2-73

Commands Listed in Alphabetical Order

Syntax

Returns

Examples

CALibrate:STA

May return PASS, DEFAULTS, or WARMUP.

CALIBRATE:STATUS:MAINFRAME? might return
CALIBRATE:STATUS:MAINFRAME PASS, indicating that the calibration status

of the mainframe is PASS.

Tus:MAInframe?

CALibrate:TEMPerature:CH<x>? (Query Only)

This is a query only command that returns the difference (in °C) between the
current sampling module channel temperature and the temperature recorded at
the last calibration information update.

Group

Syntax

Calibration

CALibrate:TEMPerature:CH<x>?

Examples

CALIBRATE:TEMPERATURE:CH2? might return
CALIBRATE:TEMPERATURE:CH2 1.5, indicating that the temperature difference

between the curr
recorded at the last calibration information update is 1.5 °C.

ent sampling module channel temperature and the temperature

CALibrate:TEMPerature:MAInframe? (Query Only)

This is a query only command that returns the difference (in °C) between the
current mainframe temperature and the temperature recorded at the last calibration
information update.

Group

Syntax

Examples

Calibration

CALibrate:TEMPerature:MAInframe?

CALIBRATE:TEMPERATURE:MAINFRAME? might return
CALIBRATE:TEMPERATURE:MAINFRAME -2.7, indicating that the

difference in temperature between the current mainframe temperature and the
temperature recorded at the last calibration information update is -2.7 °C

2-74 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

CALibrate:UP

DATEinfo:ALLModules (No Query Form)

This command (no query form) updates the calibration information for all
installed module channels into nonvolatile memories.

ommand is for service personnel only. Refer to the calibration

Group

Syntax

Examples

NOTE. This c

procedures in the Service Manual.

Calibration

CALibrate:UPDATEinfo:ALLModules

CALIBRATE:UPDATEINFO:ALLMODULES updates the nonvolatile memories of all

installed module channels with the latest calibration information.

CALibrate:UPDATEinfo:CH<x> (No Query Form)

This command (no query form) updates the calibration information in the
nonvolatile memory of the sampling module. This includes the current date and
time, temperature, and host information (such as current channel, location, model
number, and serial number).

NOTE. This command is for service personnel only. Refer to the calibration

procedures in the Service Manual.

Group

Syntax

Examples

Calibration

CALibrate:UPDATEinfo:CH<x>

CALIBRATE:UPDATEINFO:CH1 updates the nonvolatile memory of the module

occupying channel 1 with the latest calibration information.

CALibrate:UPDATEinfo:MAInframe (No Query Form)

This command (no query form) updates the calibration information in the
nonvolatile memory of the mainframe. This includes the current date, time, and
temperature.

DSA8300 Series Programmer Manual 2-75

Commands Listed in Alphabetical Order

Group

Syntax

Examples

CH<x>? (Query Only)

Group

NOTE. This comm

procedures in the Service Manual.

Calibration

CALibrate:UPDATEinfo:MAInframe

CALIBRATE:UPDATEINFO:MAINFRAME updates the nonvolatile memory of the

mainframe with the latest calibration information.

This is a query only command that returns the vertical parameters for the specified
channel. The channel is specified by x, which can be 1 through 8.

Vertical

and is for service personnel only. Refer to the calibration

Syntax

Examples

CH<x>?

CH3? might return CH3:DESKEW 0.000000000000; OFFSET

0.000000000000; UNITS AUTO; FILTER:VALUE NONE;
CH3:EXTATTEN:MODE LINEAR; VA LUE 1.000000000000; CH3:POSITION

0.000000000000; PTPEAK 0.700 000000000; SCALE 0 .700000000000

CH<x>:BANdwidth:LIST? (Query Only)

This query-only command returns a list of the available bandwidths for the
specified channel. The channel is specified by x, which can be 1 through 8.
The returned list contains the actual bandwidths a vailable for the channel. The
available bandwidths are dependent on the module.

The optical modules have differing valid settings. Use the <>:LIST? query to
determine the valid {Clock Recovery | Filter | Bandwidth | Wavelength} settings
for your optical module. Features of currently installed optical modules can be
viewed using the System Properties dialog.

To set the bandwidth for a channel, use the CH<x>:BANdwidth:VALue command.

.

Group

2-76 DSA8300 Series Programmer Manual

Vertical

Commands Listed in Alphabetical Order

Syntax

Related Commands

Examples

CH<x>:BANdwid

CH<x>:BANdwidth:VALue

CH1:BANDWIDTH:LIST? might return CH1:BANDWIDTH:LIST

20.0000000000E+009,12.49999974400E+009

available for Channel 1.

CH<x>:BANdwidth:VALue

This command sets or queries the bandwidth for the channel specified by x,
which can be 1 through 8. Sending the command is the e quivalent to selecting a
bandwidth from the Bandwidth pulldown menu in the Signal Conditioning section
of the Vertical Setup dialog box for sampling modules. The sampling module
determines the available bandwidths.

You can use the CH<x>:BANdwidth:LIST? query to determine the available
bandwidths for the specified channel.

Group

Vertical

th:LIST?

, indicating the bandwidths

Arguments

CH<x>:DELay

Syntax

Examples

CH<x>:BANdwidth:VALue <NR3>
CH<x>:BANdwidth:VALue?

NR3 is the va

CH<x>:BANdwidth:LIST? command to query the bandwidths available for the
specified channel. The instrument automatically selects the bandwidth nearest
to the input value.

CH1:BANDWIDTH:VALUE 2.0E+10 sets the Channel 1 bandwidth to 20 GHz.

CH2:BANDWIDTH:VALUE? might return CH2:BANDWIDTH:VALUE

12.49999974400E+009

to 12.5 GHz.

This command sets or queries the delay time for the channel specified by x, wh
can be 1 through 8 . Sending this command is the equivalent to setting Delay in
the Vertical Setup dialog box for the selected channel. You can adjust delay to
add or subtract an independent, channel-based acquisition time delay to the delay
from the trigger point (the horizontal position) that is inherently common to the

lue of the bandwidth you want to set. Use the

, indicating that the bandwidth for Channel 2 is set

ich

DSA8300 Series Programmer Manual 2-77

Commands Listed in Alphabetical Order

Group

Syntax

Arguments

Examples

acquisition of
introduced between channels by external cabling with unequal delays.

NOTE. Delay is only supported by sampling modules that include delay hardware.

Using delay instead of deskew will not affect overall acquisition performance
since multiple passes for acquisitions are not required.

Vertical

CH<x>:DELay<NR3>
CH<x>:DELay?

NR3 is the delay time for this channel. The range is -100% to +100% with

a resolution of 0.1%.

CH7:DELAY 0.1 sets the delay for Channel 7 to 10%.

CH3:DELAY? might returnCH3:DELAY 0.250000000 indicating that the delay

time for Channel 3 is set to 25%.

all channels. This allows you to compensate for delay differences

CH<x>:DESkew

Group

This command sets or queries the deskew time for the channel specified by x,
which can be 1 through 8. Sending this command is the equivalent to setting
Deskew in the Vertical Setup dialog box for the selected channel.

You can a djust deskew to add or subtract an independent, channel-based
acquisition time delay to the delay from the trigger point (the horizontal position)
that is inherently common to the acq
to compensate for delay differences introduced between channels by external
cabling with unequal delays.

NOTE. Setting different deskew values on dual-channel sampling modules that

use a single sampling strobe (for example, the 80E02, 80E03, 80E04 sampling
modules) reduces overall acquisition performance. In these instances, the
acquisition must digitize eac
each of the signals with the desired time alignment. This multiple pass acquisition
process applies to the acquisition of the channels within each active timebase.

Vertical

h channel on a separate acquisition pass to obtain

uisition of all channels. This allows you

2-78 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

Syntax

Arguments

Examples

CH<x>:DESkew <
CH<x>:DESkew?

NR3 is the deskew time for this channel. The range is -0.5 ns to +100 ns with a

resolution of 1 ps. Out of range values are clipped.

CH7:DESKEW 5.0E-9 sets the deskew time for Channel 7 to 5 ns.

CH3:DESKEW? might return CH3:DESKEW 10.00000000008E-009, indicating

that the deskew time for Channel 3 is set to 10 ns.

CH<x>:ERCAL? (Query Only)

This query-only command returns whether calibrated extinction ratio is available
for the optical module for the specified channel. The channel is specified by
x, which can be 1 through 8.

Group

Syntax

Vertical

CH<x>:ERCAL?

NR3>

Examples

CH<x>:EXTAtten:MODe

Group

Syntax

Arguments

CH1:ERCAL? might return :CH1:ERCAL 0, indicating that the calibrated

extinction ration is not available for the optical module in the channel 1.

NOTE. A query always returns a 0 or 1.

This command sets or queries the external attenuation mode for the c hannel
specified by x, which can be 1 through 8.

Vertical

CH<x>:EXTAtten:MODe { LINear | DB }
CH<x>:EXTAtten:MODe?

LINear sets the mode so that the attenuation value is a linear numeric

multiplier, such as 15X.

DB sets the mode so that the attenuation value is in dB.

DSA8300 Series Programmer Manual 2-79

Commands Listed in Alphabetical Order

Examples

CH<x>:EXTAtten:VALue

CH7:EXTATTEN:

Channel 7.

CH3:EXTATTEN

the external attenuation is set to the DB mode for Channel 3.

This command sets a value matching the amount of attenuation applied externally,
before the signal enters the specified input channel. The channel is specified by x,
which can be 1 through 8. The query form returns the amount of attenuation that is
set for th
when displaying vertical readouts, measurements, and so on for this channel. This
command is the equivalent to entering a value in the External Attenuation control
in the External Attenuation section of the Vertical Setup d ialog box.

Use the CH<x>:EXTAtten:MODE command to select whether the attenuation
value is set or returned as a linear attenuation (such as 15X) or as dB attenuation
(suchas10dB).

NOTE. External Attenuation (dB) = 20 * log10 (Linear) for External Attenuation

(line

e instrument. The instrument takes in to account this external a ttenuation

ar) > 0.

MODE LIN

:MODE?

sets the external attenuation mode to linear for the

might return CH3:EXTATTEN:MODE DB, indicating that

Group

Syntax

Related Commands

Arguments

Examples

For example, 0 dB=1X, 20 dB=10X, 40 dB=100X, and so on.

The external attenuation is set to 1 (linear) or 0 dB for all TDR sources and for
all channels released as TDR sources. External attenuation is set to 1 (linear) or
0 dB when you attach an external real-time accessory, such as a probe, to the

lected channel.

se

Vertical

CH<x>:EXTAtten:VALue <NR3>
CH<x>:EXTAtten:VALue?

CH<x>:EXTAtten:MODe

NR3 is the attenuation value specified as a multiplier in the range of 1.0E-6 to

1.0E+6. The default is 1.00.

CH7:EXTATTEN:VALUE 1.5E+1 sets the external attenuation for Channel 7 to

15X wh

en linear is set as the external attenuation mode.

2-80 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

CH3:EXTATTEN:

10.000000000000

Channel 3 when linear is set as the external attenuation mode.

CH<x>:FILTer:LIST? (Query Only)

This query only command returns a list of the filters available for the channel
specified by x, which can be 1 through 8. The filters available depend on the
module. Sending this command is the equivalent using the Filter pulldown in the
Signal Conditioning section o f the Optical portion of the Vertical Setup dialog box.

Use the CH<x>:FILTer:VALue command to set a filter.

Group

Syntax

Related Commands

Vertical

CH<x>:FILTer:LIST?

CH<x>:FILTer:VALue

VALUE?

might return CH3:EXTATTEN:VALUE

, indicating that the external attenuation is set to 10X for

Examples

CH<x>:FILTer:VALue

Group

Syntax

CH1:FILTER:LIST? might return CH1:FILTER:LIST
NONE,OC12,OC48,OC192

1.

This command sets or queries t
channel specified by x, which can be 1 through 8. The reference-receiver filter
selections require hardware support that may not be provided by your sampling
module; see your module user manual to determine which filters your module
supports. You can also use the CH<x>:FILTer:LIST? query to return a list of the
filters available for the specified channel.

If you select a filter that your sampling module does not support, you will receive
Execution Error code 2508, with error message "Selected filter is not available".
See Messages for general information o n programming interface messages.

Vertical

CH<x>:FILTer:VALue { NONe | CPRI7373 | ENET103R4 |
ENET103R10 | ENET257R4 | ENET1250 | ENET2500 | ENET3125 |
ENET41250 | ENET9953 | ENET10313 | ENET11096 | FC1063 |
FC2125 | FC3188 | FC4250 | FC8500 | FC8500FINAL | FC10519 |

, indicating the filters available for Channel

he reference-receiver filter that is applied to the

DSA8300 Series Programmer Manual 2-81

Commands Listed in Alphabetical Order

Related Commands

Arguments

FC11317 | FC140
| FEC10709 | FEC12500 | FEC43018 | FPELECOUT | INF2500 |
INF5000 | INF14063 | INF25781 | INFIniband | PCIX2500 |
PCIX6250 | OBS
| OC36 | OC48 | OC96 | OC192 | OC768 | OTU27952 | SATA1500 |
SATA3000 | SATA6000 | SFEC12500 | VSR5-3318 }

CH<x>:FILTer:VALue?

25 | FEC2666 | FEC42657 | FEC43018 | FEC10664

AI6144 | OC1 | OC3 | OC9 | OC12 | OC18 | OC24

CH<x>:FILTer:LIST?

NONe disables reference-receiver filtering.

CPRI7373 selects a reference-receiver filter for the 7.373 Gb/s bit rate, in

accordance with the Wireless Base Station CPRI 7.373 standard.

ENET103R4 selects a reference-receiver filter for the 10.3125 Gb/s bit rate, in

accordance with the Ethernet 40GBASE-LR4/SR4 standard.

ENET103R10 selects a reference-receiver filter for the 10.3125 Gb/s bit rate, in

accordance with the Ethernet 100GBASE-SR10 standard.

ENET257R4 selects a reference-receiver filter for the 25.78125 Gb/s bit rate, in

accordance with the Ethernet 100GBASE-ER4/LR4 standard.

ENET1250 selects a reference-receiver filter for the 1.250 Gb/s bit rate, in

accordance with the IEEE 802.3ae-2002 standard.

ENET2500 selects a reference-receiver filter for the 2.500 Gb/s bit rate (2x

Gigabit Ethernet).

ENET3125 selects a reference-receiver filter for the 3.125 Gb/s bit rate, in

accordance with the IEEE 802.3ae-2002 standard.

ENET9953 selects a reference-receiver fi lter for the 9.95328 Gb/s bit rate, in

accordance with the IEEE 802.3ae-2002 standard.

ENET10313 selects a reference-receiver filter for the 10.3125 Gb/s bit rate, in

accordance with the IEEE 802.3ae-2002 standard.

ENET11096 selects a reference-receiver filter for the 11.095728 Gb/s bit rate,

which is a forward error-correction rate for 10GbE (10.3125 Gb/s per IEEE

802.3ae-2002 standard).

ENET41250 selects a reference-receiver filter for the 41.250 Gb/s bit rate, in

accordance with the Ethernet 40GBASE-FR standard.

FC1063 selects a reference-receiver filter for the 1.0625 Gb/s bit rate, in

accordance with the ANSI X3.230-1994 standard.

FC2125 selects a reference-receiver filter for the 2.125 Gb/s bit rate, in accordance

with the ANSI Fibre Channel Physical Interface (FC-PI) Rev 11 draft standard.

2-82 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

FC3188 selects

clock recovery for the 3.1875 Gb/s bit rate, in accordance with the

proposed 10 Gigabit Fibre Channel (10GFC) standard.

FC4250 select

s a reference-receiver filter for the 4.250 Gb/s bit rate, in accordance

with the ANSI Fibre Channel Physical Interface (FC-PI) Rev 11 draft standard.

FC8500 sele

cts a reference-receiver filter for the 8.5000 Gb/s bit rate, in

accordance with the preliminary 8GFC standard.

L

FC8500FINA

selects a reference-receiver filter for the 8.5000 Gb/s bit rate, in

accordance with the Fibre Channel Optical 8GFC standard.

FC10519 se

lects a reference-receiver filter for the 10.518750 Gb/s bit rate, in

accordance with the proposed 10 Gigabit Fibre Channel (10GFC) standard.

FC11317 s

elects a reference-receiver filter for the 11.317 Gb/s bit rate, in

accordance with the proposed 10 Gigabit Fibre Channel (10GFC) standard.

FC14025

selects a reference-receiver filter for the 14.02500 Gb/s bit rate, in

accordance with the Fibre Channel Optical 16G FC MM/SM r6.1 standard.

6

FEC266

selects a reference-receiver filter for the 2.6660571 Gb/s bit rate, in

accordance with the ITU-T G.975 Recommendation.

664

FEC10

selects a reference-receiver filter for the 10.66423 Gb/s bit rate, in

accordance with the ITU-T G.975 Recommendation.

0709

FEC1

selects a reference-receiver filter for the 10.709225 Gb/s bit rate, in

accordance with the ITU-T G.709 draft Recommendation.

FEC

12500

selects a reference-receiver filter for the 12.5000 Gb/s bit rate, in

accordance with the Fibre Channel Optical 12.5G FEC standard. Replaces
the

SFEC12500 argument. If SFEC12500 is set and the filter is queried, the

instrument returns

FEC42657 selects a reference-receiver filter for the 42.657 Gb/s bit rate, in

FEC12500.

accordance with the ITU-T G.709 Recommendation.

FEC43018 selects a reference-receiver filter for the 43.018414 Gb/s bit rate, in

accordance with the ITU-T G.709 Draft Recommendation.

FPELECOUT enables the full power electrical output for optical modules. This

is not a filter.

INF2500 selects a reference-receiver filter for the 2.50 Gb/s bit rate, in accordance

with the Infiniba nd Optical standard. Replaces the

INFINIBAND is set and the filter is queried, the instrument returns INF2500.

INF5000 selects a reference-receiver filter for the 5.0 Gb/s bit rate, in accordance

INFINIBAND argument. If

with the Infiniband Optical standard.

INF14063 selects a reference-receiver filter for the 14.06250 Gb/s bit rate, in

accordance with the Infiniband FDR standard.

DSA8300 Series Programmer Manual 2-83

Commands Listed in Alphabetical Order

INF25781 selec

ts a reference-receiver filter for the 25.781 Gb/s bit rate, in

accordance with the Infiniband EDR standard.

OBSAI6144 selects a reference-receiver filter for the 6.144 Gb/s bit rate, in

accordance with the Wireless Base Station OBSAI standard.

OC1 selects a reference-receiver filter for the 51.84 Mb

/s bit rate, in accordance

with the Sonet/SDH OC-1/STM-0 standard.

OC3 selects a reference-receiver filter for the 155.52 Mb/s bit rate, in accordance

with the Sonet/SDH OC-3/STM-1 standard.

OC9 selects a reference-receiver filter for the 466.56 Mb/s bit rate, in accordance

with the Sonet/SDH OC-9/STM-3 standard.

OC12 selects a reference-receiver filter for the 622.08 Mb/s bit rate, in accordance

with the Sonet/SDH OC-12/STM-4 standard.

OC18 selects a reference-receiver filter for the 933.12 Mb/s bit rate, in accordance

with the Sonet/SDH OC-18/STM-6 standard.

OC24 selects a reference-receiver filter for the 1.24416 Gb/s bit rate, in accordance

with the Sonet/SDH OC-24/STM-8 standard.

OC36 selects a reference-receiver filter for the 1.86624 Gb/s bit rate, in accordance

with the Sonet/SDH OC-36/STM-12 standard.

Examples

CH<x>:OFFSet

OC48 selects a reference-receiver filter for the 2.48832 Gb/s bit rate, in accordance

with the Sonet/SDH OC-48/STM-16 standard.

OC96 selects a reference-receiver filter for the 4.97664 Gb/s bit rate, in accordance

with the Sonet/SDH OC-96/STM-32 standard.

OC192 selects a reference-receiver filter for the 9.95328 Gb/s bit rate, in

accordance with the Sonet/SDH OC-192/STM-64 standard.

OC768 selects a reference-receiver filter for the 39.8131 Gb/s bit rate, in

accordance with the Sonet/SDH OC-768/STM-256 standard.

OTU27952 selects a reference-receiver filter for the 27.95 Gb/s bit rate, in

accordance with the Fibre Channel Optical OTU4 standard.

CH1:FILTER:VALUE NONE disables the filtering for Channel 1.

CH2:FILTER:VALUE? might return CH2:FILTER:VALUE OC12, indicating that

the Sonet/SDH OC-12/STM-4 filter is enabled for Channel 2.

This command sets or queries the vertical offset for the spe cified channel. The
channel is specified by x, which can be 1 through 8. Setting an offset with this
command is the equivalent to entering a value in the Offset control in the Channel

2-84 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

Group

Syntax

section of the V
OFFSET knob.

Channel offse
around which the signal is sampled) for the selected channel. Visualize offset as
scrolling the acquisition window towards the top of a large signal (or one with a
positive DC bias) for increased offset values and scrolling towards the bottom for
decreased offset values. Optimal vertical accuracy (of the entire signal) is obtained
when the offset is set to the average DC bias of the input signal (that is, when it
centers th

The range and resolution of offset values for a given channel is dependent on
multiple
the probe type (if attached), the external attenuation factor, the selected units (if
TDR is active), and the scale.

For more information on how offset ranges are determined, refer to the topic
Vertical Offset in the online help for your instrument.

Vertical

CH<x>:OFFSet <NR3>
CH<x>:OFFSet?

factors: the sampling module type (specifically, its input dynamic range),

ertical Setup dialog box or adjusting the front-panel Vertical

t adjusts the vertical acquisition window (moves the DC level

e signal around the input dynamic range of the sampling module).

Related Commands

Arguments

Examples

CH<x>:POSition

<x>:POSition

CH

NR3 is the offset value for the specified channel; the range is ±1.6 V.

CH4:OFFSET 2.0E-3 sets the o ffset for Channel 4 to 2 mV.

CH3:OFFSET? might return CH3:OFFSET 0.100000000000, indicating that the

offset for Channel 3 is set to 100 mV.

This command sets or queries the vertical position of the specified channel. The
channel is specified by x, which can be 1 through 8. Sending this command is the
equivalent to setting Position in the Setup section of the Vertical Setup dialog box
or adjusting the front-panel Vertical Position knob.

Increasing the position value of a waveform causes the waveform to move up,
and decreasing the position value causes the waveform to move down. Position
adjusts only the display position of a channel, math, or reference waveform.

DSA8300 Series Programmer Manual 2-85

Commands Listed in Alphabetical Order

Related Commands

Arguments

CH<x>:SCAle

Group

Syntax

Examples

Vertical

CH<x>:POSition <NR3>
CH<x>:POSition?

CH<x>:OFFSet

<NR3> is the position value in divisions from the center graticule. The range is

±5 divisions for channels and ±1000 divisions for math and reference waveforms.

CH2:POSITION 1.3E+00 positions the Channel 2 input signal 1.3 divisions

above the center graticule.

CH1:POSITION? might return CH1:POSITION -2.000000000000, indicating

that the current position of Channel 1 is 2 divisions below the center graticule.

This command sets or queries the vertical scale of the channel specified by x,
which can be 1 through 8. Sending this command is the equivalent to setting a
value in the Scale control in the Setup section of the Vertical Setup dialog box
or adjusting the front-panel Vertical SCALE knob.

Channel scale, expressed as the per division setting, adjusts the display size for the
selected channel. Similar to the scale control for refe rence and math waveforms,
this control provides graphical scaling only; the control has no effect on the input
vertical acquisition hardware. Increasing the scale causes the waveform to be
displayed smaller. Decreasing the scale causes the waveform to be displayed
larger.

The range and resolution of scale values for a given channel is dependent on
multiple factors: the sampling module type (specifically, its input dynamic rang
the probe type (if attached), the external attenuation factor, and the selected units
(if TDR is active).

For more information on how scale ranges are determined, refer to the topic
Vertical Scale in the online help for your instrument.

Channel scale changes have an effect on the allowable o ffset range for the
channel. In general, as the vertical scale value is reduced, the amount of allowable
offset increases.

For more information on how scale affects offset range, refer to the topic Vertical
Offset in the online help for your instrument.

e),

2-86 DSA8300 Series Programmer Manual

Commands Listed in Alphabetical Order

Related Commands

CH<x>:UNIts

Group

Syntax

Arguments

Examples

Vertical

CH<x>:SCAle <NR3>
CH<x>:SCAle?

CH<x>:OFFSet, CH<x>:POSition

NR3 is the vertical channel scale in units per division.

CH4:SCALE 5.0E-01 sets the scale for Channel 4 to 500 mV per division.

CH2:SCALE? might return CH2:SCALE 0.02000000000, indicating that the

current scale setting of Channel 2 is 20 mV per division.

This command sets or queries the units for the specified channel. The channel is
specified by x, which can be 1 through 8. Sending this command is the equivalent
to setting the Units control in the Channel section o f the Vertical Setup dialog
box. You can use this control to override the automatic selection of units for the
selected channel. If you set this value to AUto, the instrument automatically
selects the units. If you set this value to Volt, Watt, or Amp, the instrument will
apply these units to the vertical axis.

Group

Syntax

The selections in this control are Auto, Volt, Amp, and Watt. When you
change the units setting, all vertical units are reported as specified and no data
transformations take place.

For TDR waveforms, the Units control in the Vertical Setup dialog box is not
active. Use the TDR:CH<x>:UNIts command to set and query units in TDR.
The units available are Rho, Ohm, and Volt. When you change units of TDR
waveforms, data transformations take place. The default is Rho.

Vertical

CH<x>:UNIts { AU
CH<x>:UNIts?

to | Volt | Watt | Am p }

DSA8300 Series Programmer Manual 2-87

Commands Listed in Alphabetical Order

Arguments

Examples

CH<x>:WFMLabel

Group

AUTO sets the un

determined by the instrument (depends on the probe attached to the specified
channel).

Volt sets the vertical-axis units for the specified channel to volts.

Watt sets th

Amp sets the vertical-axis units for the specified channel to amperes.

CH4:UNITS AUTO sets the vertical axis units for Channel 4 so that they are

determined automatically by the instrument.

CH1:UNITS? might return CH1:UNITS VOLT, indicating that the vertical-axis

units for Channel 1 are set to volts.

This command sets or queries the label associated with the channel waveform
specified.

Vertical

its for the specified channel so that they are automatically

e vertical-axis units for the specified channel to watts.

Syntax

Related Commands

Arguments

Examples

CH<x>:WFMLabel <Qstring>
CH<x>:WFMLabel?

MATH<x>:WFMLabel, REF<x>:WFMLabel

Qstring sets the label for the waveform.

CH1:WFMLABEL "MY CH1 WAVEFORM" sets the label for CH1 to be "My CH1

waveform," which is the label displayed with the waveform when it is displayed
on screen.

CH1:WFMLABEL? might return CH1:WFMLABEL "MY CH 1 WAVEFORM",

indicating that the label for c hannel 1 is set to "My CH1 waveform".

CH<x>:WLENgth:LIST? (Query Only)

This query only command returns a list of the available wavelengths for the
channel specifi
in slots CH1 or CH3 have wavelength selections. The returned list contains the

ed by x, which can be 1 through 8. Generally, only optical modules

2-88 DSA8300 Series Programmer Manual