Tektronix AWG5202, AWG5204, AWG5208 Programmer

Download

AWG5200 Series Arbitrary Waveform Generators

Programmer

Revision A

*P077133700*

077-1337-00

AWG5200 Series Arbitrary Waveform Generators

Programmer

Revision A

www.tek.com

077-1337-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. Speciﬁcations and price change privileges reserved.

TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.

Supports product software version 6.0 and above.

Contacting Tektronix

Tektronix, Inc. 14150 SW Karl Braun Drive P.O. B o x 5 0 0 Beaverto USA

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

n, OR 97077

In North America, call 1-800-833-9200. Worldwide, visit www.tek.com to ﬁnd contacts in your area.

Table of Contents

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

Getting Started

Introduction ....................................................................................................... 1-1

Remote control........... .................................. ................................ ....................... 1-2

Ethernet control ......................................................................................... 1-2

GPIB control............................................................................................. 1-2

Syntax and Commands

Command syntax .............. .................................. ................................ ................. 2-1

Syntax overview .......... ................................ ................................ ................... 2-1

Command and query structure ...................... .................................. ..................... 2-1

Clearing the instrument ..................................................................................... 2-2

Command entry .............................................................................................. 2-3

Parameter types .............................................................................................. 2-4

SCPI commands and queries ................................ ................................ ............... 2-8

Sequential, blocking, and overlapping commands ........ ................................ ............... 2-9

Command groups........ ................................ ................................ ....................... 2-13

Auxiliary out commands ..... . ..... . ..... . .... . ..... . ..... . ..... . ... . . . .... . ..... . ..... . ..... . ..... . .... . . 2-13

Basic waveform editor commands............ ................................ ........................... 2-13

Calibration group commands...... ................................ .................................. ..... 2-14

Capture and playback group commands ................................................................ 2-15

Clock group commands...... ................................ ................................ ............. 2-16

Control group commands ................................................................................. 2-17

Diagnostic group commands ............................................................................. 2-18

Display group commands................................................................................. 2-19

Function generator group commands .................................................................... 2-20

IEEE mandated and optional group commands ........................................................ 2-20

Instrument group commands ............................................................................. 2-21

Mass memory group commands ......................................................................... 2-21

Output group commands ................... ................................ ............................... 2-23

S-Parameters group commands .......................................................................... 2-23

Sequence group commands.................................. ................................ ............. 2-25

Source group commands .................................................................................. 2-27

Status group commands ................................................................................... 2-29

Synchronization group commands.......... ................................ ............................. 2-29

System group commands ................................................................................. 2-30

Trigger group commands ...... .................................. ................................ ......... 2-31

AWG5200 Series Programmer Manual i

Table of Contents

Waveform group

Waveform plug-in group commands.................. ................................ ................... 2-33

Command descriptions.............................. .................................. ......................... 2-35

Status and Events

Status and e

Status and event reporting system ......................................................................... 3-1

Status byte.................................................................................................... 3-3

Standard Event Status Block (SESB).. . ..... . ..... . ..... . ... . . . .... . . .... . ..... . ..... . ..... . ..... . ..... . .. 3-4

Operation status block...................... ................................ ................................ . 3-5

Questionable status block ...................... .................................. ........................... 3-6

Queues ........................................................................................................ 3

Status and event processing sequence ...................... .................................. ............. 3-8

Synchronizing execution ............................. .................................. ..................... 3-9

Error messages and codes .................... ................................ ................................. 3-11

Command errors ............ ................................ ................................ ............... 3-11

Execution errors..... ................................ .................................. ..................... 3-12

Devic

Query and system errors .................................................................................. 3-15

Instrument speciﬁc error codes........................................................................... 3-15

vents ................................................................................................. 3-1

especiﬁc errors .. ................................ .................................. ................. 3-14

commands.............................................................................. 2-31

-7

Appendices

endix A: Character charts.... ................................ ................................ .............. A-1

App

Appendix B: Raw socket speciﬁcation........................................................................ B-1

Appendix C: Factory initialization settings ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . . C-1

ii AWG5200 Series Programmer Manual

Preface

This programmer guide provides you with the information required to remotely control your instrument.

In addition to this manual, other resources available about your instrument include the following documents.

Documentat

ion

Review the following table to locate more information about this product.

You c a n do w n load P D F ﬁles of the documents from www.tek.com/manual/downloads.

To read about Use these documents

Installation and Safety Read the Installation and Safety manual for proper instrument

installation and general safety information.

This document is provided with the instrument and is also available for download from the Tektronix web site.

Operation and User Interface Help

Programmer commands

Speciﬁcations and Performance Veriﬁcation procedures

Access the user help from the Help menu for information on controls and screen elements.

The user help information is also available as a PDF ﬁle available from the Tektronix web site.

The Programmer document provides the proper syntax of remote commands.

This document is available for download from the Tektronix w eb site.

This Technical Reference document provides the speciﬁcations and the performance veriﬁcation procedures.

This document is available for download from the Tektronix w eb site.

AWG5200 Series Programmer Manual iii

Preface

iv AWG5200 Series Programmer Manual

Getting Started

Introduction

This programmer guide provides you with the information required to use Programmable Interface (PI) commands for remotely controlling your instrument over a LAN electronic interface. With this information, you can write computer programs that perform functions such as setting the front-panel controls, selecting clock sourc

In addition to the LAN electronic interface, your AWG is provided with a TekV I S A GPIB-comp

The programmer guide is divided into the following major sections:

Getting Started: p rovides basic information about setting up your AWG for remote control.

Syntax and Commands: provides an overview of the command syntax used to communicate with the instrument and other general information about command commands, constructed mnemonics, and argument types.

e, setting sampling rate, and exporting data for use in other programs.

atible interface, (referred to as the virtual GPIB interface).

s, such as how commands and queries are constructed, how to enter

Comman

Command groups: contains all the commands listed in functional groups.

Each g table that lists all the commands and queries for that group.

us and Events: discusses the status and event reporting system for the

Stat LAN interface. This system informs you of certain signiﬁcant events that occur within the instrument.

Appendices: contains miscellaneous information, such as LAN interface speciﬁcations that may be helpful when using remote commands.

d syntax:

roup consists of an overview of the commands in that group and a

AWG5200 Series Programmer Manual 1-1

Remote control

You can remotely control communications between your instrument and a PC via Ethernet or GPIB cables. Refer to the following sections describing the setups and connections

required.

Ethernet control

If you are using Ethernet, start by connecting an appropriate Ethernet cable to the Ethernet port (RJ-45 connector) on the rear panel of the instrument. This connects the instrument to a 10BASE-T/100BASE-TX/1000BASE-T local area network.

The AWG accepts two types of Ethernet LAN connections:

VXI-11 Server: VXI-11 protocol is used through TekVISA. TekVISA is preinstalled on the instrument, but to use this protocol, TekVISA must also be installed on the remote controller (PC).

Raw Socket: Raw Socket is used through TekVISA. To use this protocol, TekVISA must also be installed on the remote controller (PC).

IP address. By default, the AWGs are speciﬁed to automatically acquire an IP address by DHCP. Refer to Windows documentation regarding network-related parameters.

GPIB control

1-2 AWG5200 Series Programmer Manual

The AWG has a USB 2.0 high-speed (HS) Device port to control the instrument through USBTMC or GPIB with a TEK-USB-488 Adapter. The USBTMC protocol allows USB devices to communicate using IEEE488 style messages. This lets you run your GPIB software applications on USB hardware.

To use GPIB (General Purpose Interface Bus), start by connecting an appropriate

SB cable to the USB 2.0 high-speed (HS) device port on the rear panel of the

U AWG. Connect the other end to the TEK-USB-488 Adapter host port. Then connect a GPIB cable from the TEK-USB-488 Adapter to your PC.

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

Remote control

A unique device devices can share the same device address.

No more than 15

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

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

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

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

The default setting for the GPIB conﬁguration is GPIB Address 1. If you need to change the GPIB address, do the following:

1. Display the Utilities screen and select System.

2. Set the GPIB address.

3. If the TEK-USB-488 adapter is connected to the instrument, disconnect and

reconnect the adapter to ensure the new address is acquired.

address must be assigned to each device on the bus. No two

devices can be connected to any one line.

AWG5200 Series Programmer Manual 1-3

Remote control

1-4 AWG5200 Series Programmer Manual

Syntax and Commands

Command syntax

Syntax overvi

Control the operations and functions of the AWG through the LAN interface using commands and queries. The related topics listed below describe the syntax of these com AWG uses to process them. See the Command Groups topic for a listing of the commands by command group or use the index to locate a speciﬁc command.

Refer to the following table for the symbols that are used.

Table 2-1: Syntax symbols and their meanings

Symbol Meaning

::=

| Exclusive OR

{ } Group; one element is required

[] ...

( ) Comment

mands and queries. The topics also describe the conventions that the

Deﬁned element

Is deﬁned as

Optional; can be omitted

Previous elements can be repeated

mand and query structure

Com

Overview

Messages

Commands consist of set commands and query commands (usually called commands and queries). Commands modify instrument settings or tell the

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

in data and status information.

ost commands have both a set form and a query form. The query form

M of the command differs from the set form by its question m ark o n the end. For example, the set command

AWGControl:RSTate?. Not all commands have both a set and a query form.

Some commands have only set and some have only query.

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

AWGControl:RSTate has a query form

AWG5200 Series Programmer Manual 2-1

Command syntax

Commands

Table 2-2: Mess

Symbol Meaning

<Argument

<Comma> A single c

<Space>

Comman

age symbols and their meanings

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 ( other commands, 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 mnemoni colon (:) character always separates them from each other.

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

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 multipl

:) character. If the command is concatenated with

c. If a command header has multiple mnemonics, a

antity, quality, restriction, or limit associated with the

comma> separates arguments from each other.

omma is used between arguments of multiple-argument

e white space characters.

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

the settings. Commands have the structure:

Queries

Clearing the instrument

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

[:]<H

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

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

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

Queries cause the instrument to return status or setting information. Queries have the structure:

[:]<Header>?

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

[

Use the Device Clear (DCL) or Selected Device Clear (SDC) functions to clear the Output Queue and reset the instrument to accept a new command or query.

2-2 AWG5200 Series Programmer Manual

Command entry

Command syntax

Rules

Abbreviating

Concatenating

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.

You c an abbreviate many instrument commands. Each command in this documentation shows the abbreviations in capitals. For example, enter the command

TRIGger:LEVel simply as TRIG:LEV.

Use a semicolon (;) to concatenate any combination of s et commands and queries. The instrument executes concatenated commands in the order received. When concatenating commands and queries, follow these rules:

1. Separate completely different headers by a semicolon and by the beginning colon on all commands except the ﬁrst one. For example, the commands

TRIGger:IMPedance 50 and SOURce:RMODe TRIGgered, can be

catenated into the following single command:

con

TRIGger:IMPedance 50;:RMODe TRIGgered

2. If concatenated commands have headers that differ by only the last mnemonic, you can abbreviate the second command and eliminate the beginning

lon. For example, you can concatenate the commands

EXTernal

RIGger:SOURce EXTernal; SLOPe NEGative

and TRIGger:SLOPe NEGative into a single command:

TRIGger:SOURCE

The longer version works equally well:

TRIGger:SOURCE EXTernal;:TRIGger:SLOPe NEGative

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

AWG5200 Series Programmer Manual 2-3

Command syntax

Terminating

4. When you concat

enate queries, the responses to all the queries are concatenated into a single response message. For example, if the high level of marker one of channel one is 1.0 V and the low level is

0.0 V, the concatenated quer y

SOURce1:MARKer1:VOLTage:LOW? will return the following:

SOURce1:MARKer1:VOLTage:HIGH?;

1.0;0.0

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

TRIGger:SOURce EXTernal; SLOPe? is a valid message that

sets the trigger source to External. The message then queries the external trigger slope. Concatenated commands and queries are executed in the order received.

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

Table 2-3: Message terminator and meaning

Symbol Meaning

<EOM>

Message terminator

For messages sent to the instrument, the end-of-message terminator must be the END message (EOI asserted concurrently with the last data byte). The instrument always terminates messages with LF and EOI. It allows white space before the terminator. For example, it allows CR LF.

Parameter types

Parameters are indicated by angle brackets, such as <ﬁle_name>. T here are several different types of parameters, as listed in the following table. The parameter type is listed after the parameter. Some parameter types are deﬁned speciﬁcally for the instrument command set and some are deﬁnedbySCPI.

Table 2-4: Parameter types, their descriptions, and examples

Parameter type Description Example

Arbitrary block

Boolean Boolean numbers or values

Discrete

NaN Not a Number 9.91

A block of data bytes #512234xxxxx... where 5

indicates that the following 5 digits (12234) specify the length of the data in bytes; xxxxx... indicates actual data or #0xxxxx...<LF><&EOI>

ON or ≠ 0

OFF or 0

Alistofspeciﬁc values

MINimum, MAXimum

2-4 AWG5200 Series Programmer Manual

Command syntax

Table 2-4: Parameter types, their descriptions, and examples (cont.)

Parameter type Description Example

NR1 numeric Integers 0, 1, 15, –1

NR2 numeric Decimal numbers 1.2, 3.141,–6.5

NR3 numeric Floating point numbers 3.1415E+9

NRf numeric

String

Flexible decimal numbers that may be type NR1, NR2, or NR3

Alphanumeric characters (must be within quotation marks)

See NR1, NR2, and NR3 examples in this table

"Testing 1, 2, 3"

About MIN, MAX

Block

You can also use MINimum and MAXimum keywords in the commands with the "Numeric" parameter. Set the minimum value or the maximum value using these keywords and query these values.

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

Table 2-5: Block symbols and their meanings

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

<Dig> A digit character, in the range of 0–9

ough 255 decimal) that represents actual data

thr

lock of data bytes deﬁned as:

<Block> ::={#<NZDig><Dig>[<Dig>...][<DChar>...]

|#0[<DChar>...]<terminator>}

AWG5200 Series Programmer Manual 2-5

Command syntax

Arbitrary block

Quoted string

An arbitrary bl

ock argument is deﬁned as:

#<NZDig><Dig>[<Dig>...][<DChar>...]

#0[<DChar>...]<terminator>

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

#0 means that the <Block> is a n indeﬁnite length block. The <terminator> ends the block.

NOTE. The AWGs do not support the indeﬁnite format (a block starts with #0).

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

r example: "this is a quoted string". This documentation represents these

("). Fo argumentsasfollows:

Table 2-6: String symbol and meaning

Symbol Meaning

<QString > Quoted string of ASCII text

A quoted string can include any character deﬁned in the 7-bit ASCII character

. Follow these rules when you use quoted strings:

set

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

ample: "this is a valid string".

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

revious rule. For example, "this is an 'acceptable' string".

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

uote.

For example: "here is a "" mark".

4. Strings can have upper or lower case characters.

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

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

2-6 AWG5200 Series Programmer Manual

Command syntax

Units and SI preﬁx

Here are some in

valid strings:

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

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

If the decimal numeric argument refers to voltage, frequency, impedance, or time, express it using SI units instead of using the scaled explicit point input value format <NR3>. (SI preﬁxes are standardized for use in the International System of Units by the International Bureau of Weights and Measures.) For example, use the input format 200 mV or 1.0 MHz instead of 200.0E-3 or 1.0E+6, respectively, to specify voltage or fre quency.

Omit the unit when you describe commands, but include the SI unit preﬁx. Enter both uppercase and lowercase characters. The following list shows examples of units you c an use with the commands.

V for voltage (V).

HZ for frequency (Hz).

OHM for impedance (ohm).

S for time (s).

DBM for power ratio.

PCT for %.

VPP for Peak-to-Peak Voltage (V p-p).

UIPP for Peak-to-Peak, Unit is UI (UI p-p).

UIRMS for RMS, Unit is UI (UIrms).

SPP for Peak-to-Peak, Unit is second (s p-p).

SRMS for RMS, Unit is second (srms).

V/NS for SLEW’s unit (V/ns).

The SI preﬁxes, which must be included, are shown in the following table. You can enter both uppercase and lowercase characters.

Table 2-7: SI preﬁxes and their indexes

SI preﬁx

EX 10

PE 10

T10

MA 10

K10

Corresponding power

AWG5200 Series Programmer Manual 2-7

Command syntax

Table 2-7: SI preﬁxes and their indexes (cont.)

SI preﬁx

M10

N10

P10

F10

A10

Note that the preﬁxm/Mindicates10–3when the decimal numeric argument denotes voltage or time, but indicates 10

Note that the preﬁx u/U is used instead of "μ".

when it denotes frequency.

Corresponding power

–3

–6

–9

–12

–15

–18

Since M (m) can be interpreted as 1E-3 or 1E6 depending on the units, use mV for V, and MHz for Hz.

The SI preﬁxes need units.

correct: 10MHz, 10E+6Hz

incorrect: 10M

SCPI commands and queries

The AWG uses a command language based on the SCPI standard. The SCPI (Standard Commands for Programmable Instruments) standard was created by a consortium to provide guidelines for remote programming of instruments. These guidelines provide a consistent programming environment for instrument control and data transfer. This environment uses deﬁned programming messages, instrument responses and data formats that operate across all SCPI instruments, regardless of manufacturer.

The SCPI language is based on a hierarchical or tree structure that represents a subsystem (see following ﬁgure). The top level of the tree is the root node; it is followed by one or more lower-level nodes.

, 10E+6

You can create commands and queries from these s ubsyste m hierarchy trees. Commands specify actions for the instrument to perform. Queries return measurement data and information about parameter settings.

2-8 AWG5200 Series Programmer Manual

Command syntax

Sequential, b

Sequential commands

locking, and overlapping commands

Programming commands (and queries) fall into three command type categories:

Sequential

Blocking

Overlapping

Thetypeof could cause unexpected results if not handled correctly. See the following explanations and examples.

Most of th means a command will not start until the previous command has ﬁnished.

Followi

command is important to consider when programming since they

e programming commands are sequential type commands. This simply

ng is an example of a series of sequential commands.

Blocking commands

In normal operation, these commands could all be sent at once and they would be queued up and execute d sequentially.

The AWG5200 series instruments have several commands that are blocking. A blocking command does not allow any further commands to be executed until it is ﬁnished performing its task, such a s a command that changes a hardware setting.

Blocking commands perform similar to sequential commands, but they tend to take a longer amount of time to complete. Because of the time for a blocking command to complete, if a number of blocking commands are run in a sequence

ollowed by a query, the query could time out because the previous blocking

f commandshavenotﬁnished.

locking commands are noted in their command descriptions.

AWG5200 Series Programmer Manual 2-9

Command syntax

Overlapping commands

Overlapping co additional commands to start before the overlapping command has ﬁnished. The illustration below shows how a series of overlapping commands might start and end.

In some instances, you may want to make an overlapping command perform similarly to a sequential command. This is simply done by placing a *WAI command after the overlapping command as illustrated below.

mmands run concurrently with other commands, allowing

You always want to ensure the overlapping command has completed. This is done by using the *OPC? command. When an overlapping command starts, the operation complete status event is cleared. When the overlapping command completes, the operation complete status event is set. The *OPC? command requirementistoreturna1whentheoperation complete status event is set. In the illustration below, the OPC? command blocks any further commands from being executed until the operation complete status event is set.

NOTE. Always ensure overlapping commands have completed by placing an

*OPC? command after the overlapping command.

2-10 AWG5200 Series Programmer Manual

Command syntax

The AWG5200 ser command per *OPC?. If two or more overlapping commands are sent and followedbyan*OPC?,thentheﬁrst overlapped command to ﬁnish will set the operation complete status event and *OPC? will return 1. This early return may produce undesirable results. The following illustration shows this behavior.

NOTE. The *OPC? query only supports one overlapping command, not the two or

more over

Overlapping commands are noted in their command descriptions.

lapping commands as deﬁned in the IEEE Std 488.2 standard.

ies instruments are limited to one outstanding overlapping

AWG5200 Series Programmer Manual 2-11

Command syntax

2-12 AWG5200 Series Programmer Manual

Command groups

This section contains tables that divide the commands into common groups. A brief description of the command is provided. Use the link provided to jump directly to t and examples.

Commands noted for backwards compatibility should not be used for new programming applications.

Auxiliary out commands

Use the Auxiliary out commands to setup and control the Auxiliary outputs on the rear panel.

Table 2-8: Auxiliary output group commands and their descriptions

Command Description

AUXoutput[n]:SOURce Sets or returns the signal source for the speciﬁed Auxiliary Output

AUXoutput[n]:SOURce:CMAPping Sets or returns the Auxiliary O utput channel mapping.

he command description, providing: a detailed description, syntax,

connector.

Basic waveform editor commands

Use the Basic waveform editor commands to setup and create waveforms using the Basic waveform editor plug-in.

Table 2-9: Basic waveform editor group commands and their descriptions

Command Description

BWAVeform:AMPLitude Sets or returns the peak-to-peak Amplitude value for the waveform created

by the Basic Waveform editor plug-in.

BWAVeform:AUTO Sets or returns the Basic Waveform editor plug-in Auto Ca

determining which value is automatically calculated.

BWAVeform:COMPile Initiates the Basic Waveform editor plug-in compile process.

BWAVeform:COMPile:CASSign Sets or returns the state (enabled or disabled) of the Basic Waveform

editor to compile the waveform and immediately assign it to a speciﬁed channel (enabled) or just compile the waveform (disa

BWAVeform:COMPile:CHANnel Sets or returns playout the channel intended for the c

the Basic Waveform editor plug-in. T he selected channel is also used to set the amplitude and offset range.

BWAVeform:COMPile:NAME Sets or returns the name of the Basic Waveform editor plug-in compiled

waveform.

BWAVeform:COMPile:PLAY Sets or returns the state (enabled or disabled) of

to either immediately play the waveform after compile or just compile.

the Basic Waveform editor

lculate setting,

bled).

ompiled waveform of

AWG5200 Series Programmer Manual 2-13

Command groups

Table 2-9: Basic waveform editor group commands and their descriptions (cont.)

Command Description

BWAVeform:CYCLe Sets or returns the Cycle value (number of times the waveform repeats) for

the waveform created by the Basic Waveform editor plug-in.

BWAVeform:FDRange Sets or returns the state (enabled or disabled) of the Basic Waveform

editor plug-in to use or not use the full DAC range during compile. Using the full DAC range when compiling waveforms results in waveforms with the best resolution.

BWAVeform:FREQuency Sets or returns the Frequency for the waveform created by the Basic

Waveform editor plug-in.

BWAVeform:FUNCtion Sets or returns the Basic Waveform editor plug-in waveform type.

BWAVeform:HIGH Sets or returns the High voltage value for the waveform created by the

Basic Waveform editor plug-in.

BWAVeform:LENGth Sets or returns the Length for the waveform created by the Basic Waveform

editor plug-in.

BWAVeform:LOW Sets or returns the Low voltage value for the waveform created by the

Basic Waveform editor plug-in.

BWAVeform:OFFSet Sets or returns the Offset voltage value for the waveform created by the

Basic Waveform editor plug-in.

BWAVeform:RESet Resets the Basic Waveform editor plug-in to its default values.

BWAVeform:SRATe Sets or returns the Sample Rate for the waveform created by the Basic

Waveform editor plug-in.

Calibration group commands

Use the calibration commands to calibrate the arbitrary waveform generator and obtain calibration data.

Table 2-10: Calibration group commands and their descriptions

Command Description

CALibration:ABORt Stops the self calibration process and restores the previous calibration

constants.

CALibration[:ALL] Performs a full calibration of the AWG. The query form performs a full

calibration and returns a status of the operation.

CALibration:CATalog? Returns the list of subsystems, areas, or procedures.

CALibration:LOG? Returns a string of continuous concatenated calibration results.

CALibration:LOG:CLEar Clears the results log.

CALibration:LOG:FAILuresonly Sets and returns the ﬂag that controls the amount of result information

saved into the log.

CALibration:RESTore Restores the calibration constants from the factory non-volatile memory

and copied to user storage.

2-14 AWG5200 Series Programmer Manual

Command groups

Table 2-10: Calibration group commands and their descriptions (cont.)

Command Description

CALibration:RESult? Returns the status about the results of the last start of a set of selected

calibration procedures.

CALibration:RESult:TEMPerature? Returns the temperature from the results of the last start of a set of

selected procedures.

CALibration:RESult:TIME? Returns the time from the results of the last start of a set of selected

procedures.

CALibration:RUNNing? Returns the name of the subsystem, area, and procedure in progress.

CALibration:STARt Starts the selected set of calibrations.

CALibration:STATe:FACTory? Returns the current factory state of the calibration for the AWG.

CALibration:STATe:USER? Returns the current factory state of the calibration for the AWG.

CALibration:STOP:STATe? Returns the state of the calibration procedure.

Capture and playback group commands

Use the capture and playback commands to import I/Q data ﬁles to compile into RF waveform ﬁles for playout.

Table 2-11: Capture and playback group commands and their descriptions

Command Description

CPLayback:CAPTure:FILE Imports baseband IQ waveform data and adds the waveform to the

speciﬁed Signal Name in the captured signal list.

CPLayback:CAPTure:INSTrument:OSCilloscope Connects to the speciﬁed oscilloscope, transfers the existing acquisition

from the oscilloscope to the AWG, and adds it to the speciﬁed signal.

CPLayback:CAPTure:INSTrument:RSA Connects to the speciﬁed RSA (Realtime Spectrum Analyzer), transfers

the existing acquisition to the AWG, and adds it to the speciﬁed signal.

CPLayback:CLISt:NAME? Returns the name of a signal from the Captured Signal List in the position

speciﬁed by the index value.

CPLayback:CLISt:SIGNal:DELete Removes the speciﬁed signal from the Captured Signal List.

CPLayback:CLISt:SIGNal:SCOMpile Selects or deselects a signal from the captured signal list to be compiled.

The query form returns the list of selected ﬁles.

CPLayback:CLISt:SIGNal:WAVeform:FOFFset This command sets or returns the frequency offset of the speciﬁed

waveform segment of the speciﬁed signal in the Captured Signal List.

CPLayback:CLISt:SIGNal:WAVeform:NAME? Returns the name of the speciﬁed waveform segment of the speciﬁed

signal in the Captured Signal List.

CPLayback:CLISt:SIGNal:WAVeform:OTIMe Sets or returns the Off time between waveform segments of the speciﬁed

signal in the Captured Signal List.

CPLayback:CLISt:SIGNal:WAVeform:SRATe Sets or returns the sample rate of a waveform segment of a signal in the

captured signal list.

CPLayback:CLISt:SIGNal:WCOunt? Returns the number of waveforms in the speciﬁed signal in the Captured

Signal List.

AWG5200 Series Programmer Manual 2-15

Command groups

Table 2-11: Capture and playback group commands and their descriptions (cont.)

Command Description

CPLayback:CLISt:SIZE? Returns the number of signals in the Captured Signal List.

CPLayback:COMPile Resamples and upconverts the selected signal to the speciﬁed carrier

frequency. A sequence will be generated if selected signal contains more than one waveform or off time is speciﬁed. Otherwise, a waveform will be generated.

CPLayback:COMPile:CFRequency Sets or returns the carrier frequency for the compiled signals.

CPLayback:COMPile:LSEQuence Sets or returns if the compiled sequence should loop on itself.

CPLayback:COMPile:NORMalize Sets or returns if the IQ waveforms will be normalized during import.

CPLayback:COMPile:SRATe Sets or returns the output sampling rate for the compiled signals.

CPLayback:COMPile:SRATe:AUTO Sets or returns if the system will calculate the output sampling rate

automatically when compiling the selected signals.

Clock group commands

Use the clock commands to deﬁne the instrument’s sampling rate and adjust clock and reference sources.

Table 2-12: Clock group commands and their descriptions

Command Description

CLOCk:ECLock:DIVider Sets or returns the divider rate of the external clock.

CLOCk:ECLock:FREQuency Sets or returns the expected frequency being provided by the external

clock.

CLOCk:ECLock:FREQuency:DETect Detects the frequency of the signal applied to the Clock In connector and

adjusts the system to use the signal.

CLOCk:ECLock:MULTiplier Sets or returns the multiplier rate of the external clock.

CLOCk:EREFerence:DIVider Sets o r r eturns the divider rate of the external reference oscillator.

CLOCk:EREFerence:FREQuency Sets or returns the expected frequency of the signal applied to the EXT

REF input connector.

CLOCk:EREFerence:FREQuency:DETect Detects the frequency of the signal applied to the EXT REF input connector

and adjusts the system to use the signal.

CLOCk:EREFerence:MULTiplier Sets or returns the multiplier rate of the variable external reference signal.

CLOCk:JITTer Sets or returns the state (enabled or disabled) to apply or not apply jitter

reduction to the internal system clock or the clock signal applied to the Reference In connector.

CLOCk:OUTPut:FREQuency? Returns the frequency of the output clock.

CLOCk:OUTPut[:STATe] Sets or returns the output state of the clock output.

CLOCk:PHASe[:ADJust[:DEGRees]] Sets or returns the phase adjustment, in units of degrees, to synchronize

multiple AWGs when using an external trigger.

CLOCk:PHASe[:ADJust]:TIMe Sets or returns the internal clock phase adjustment of the AWG.

2-16 AWG5200 Series Programmer Manual

Command groups

Table 2-12: Clock group commands and their descriptions (cont.)

Command Description

CLOCk:SOURce Sets or returns the source of the clock.

CLOCk:SOUT[:STATe] Sets or returns the state (enabled or disabled) of the Sync Clock Out output.

CLOCk:SRATe Sets or returns the sample rate for the clock.

Control group commands

Use the control commands to control oper

ating modes, such as the run state,

and pattern jump.

The commands noted for backwards compatibility should not be used for new programming applications.

Table 2-13: Control group commands and their descriptions

Command Description

AWGControl:ARSettings Sets or returns the state (enabled or disabled) of whether or not to apply

the recommended settings of waveforms and sequences when they are assigned to a channel.

AWGControl[:CLOCk]:DRATe

NOTE. This command e xists for backwards compatibility. Use the command CLOCk:ECLock:DIVider.

Sets or returns the divider rate for the external clock.

AWGControl:CLOCk:PHASe[:ADJust]

NOTE. This command e xists for backwards compatibility. Use the command CLOCk:PHASe[:ADJust]:TIMe.

Sets or returns the phase of the internal clock.

AWGControl[:CLOCk]:SOURce

NOTE. This command e xists for backwards compatibility. Use the command CLOCk:SOURce.

Sets or returns the clock source.

AWGControl:COMPile Compiles an equation ﬁle and imports the waveforms (created by the

equation ﬁle) into the arbitrary waveform generator.

AWGControl:CONFigure:CNUMber? Returns the number of channels available on the AWG.

AWGControl:PJUMp:JSTRobe Sets or returns if the pattern jump is set (enabled or disabled) to always

occur on the strobe signal.

AWGControl:PJUMp:SEDGe Sets or returns the active Strobe Edge to use for Pattern Jump when

Pattern Jump is enabled for Sequencing.

AWGControl:RMODe

NOTE. This command e xists for backwards compatibility. Use the command [SOURce[n]:]RMODe.

Sets or returns the run mode of the AWG.

AWGControl:RSTate? Returns the state of the AWG.

AWG5200 Series Programmer Manual 2-17

Command groups

Table 2-13: Control group commands and their descriptions (cont.)

Command Description

AWGControl:RUN[:IMMediate] Initiates the output of a waveform or sequence.

AWGControl:SNAMe?

AWGControl:SREStore

Returns the most recently saved setup location.

NOTE. This command exists for backwards compatibility. Use the command MMEMory:OPEN:SETup.

Opens a setup ﬁle into the AWG’s setup memory.

AWGControl:SSAVe

NOTE. Th

is command e xists for backwards compatibility.

Use the command MMEMory:SAVE:SETup

Saves the AWG's setup with waveforms.

AWGControl:STOP[:IMMediate] Stops the output of a waveform or sequence.

Diagnostic group commands

Use the diagnostic commands to control self-test diagnostic routines.

Table 2-14: Diagnostic group commands and their descriptions

Command Description

ACTive:MODE

DIAGnostic:ABORt Stops the current diagnostic test.

DIAGnostic:CATalog? Returns the list of all diagnostic tests per selected type.

DIAGnostic:CONTrol:COUNt Sets or returns the number of loop counts used when the selected loop

DIAGnostic:CONTrol:HALT Determines or returns whether the next execution of diagnostics looping

DIAGnostic:CONTrol:LOOP Determines or queries w hether the next start of diagnostics runs once, runs

DIAGnostic:DATA? Returns the results of last executed tests for the NORMal diagnostic type.

DIAGnostic[:IMMediate] Executes all of the NORMal diagnostic tests. The query form executes the

DIAGnostic:LOG? Returns a string of continuous concatenated test results.

DIAGnostic:LOG:CLEar Clears the diagnostics results log.

DIAGnostic:LOG:FAILuresonly Sets or returns the ﬂag that controls the amount of result information saved

DIAGnostic:LOOPs? Returns the number of times that the selected diagnostics set was

DIAGnostic:RESult? Returns the status about the results of the last start of a set of selected

Enables and disables access to diagnostics or calibration.

mode is "COUNt".

stops on the ﬁrst diagnostic failure that occurs or continues to loop on the selected set of diagnostic functions.

continuous loops, or loops for a number times for the selected set of tests.

selected tests and returns the results.

into the log.

completed during the current running or the last diagnostic running of the set.

tests.

2-18 AWG5200 Series Programmer Manual

Command groups

Table 2-14: Diagnostic group commands and their descriptions (cont.)

Command Description

DIAGnostic:RESult:TEMPerature? Returns the temperature from the results of the last start of a set of

selected tests.

DIAGnostic:RESult:TIME? Returns the time from the results of the last start of a set of selected tests.

DIAGnostic:RUNNing? Returns the name of the subsystem, area, and test of the current diagnostic

test.

DIAGnostic:SELect Selects one or more tests of the current test list.

DIAGnostic:SELect:VERify? Returns selection status of one speciﬁctest.

DIAGnostic:STARt This command starts the execution of the selected set of diagnostic tests.

DIAGnostic:STOP Stops the diagnostic tests from running, after the diagnostic test currently

in progress completes.

DIAGnostic:STOP:STATe? Returns the current state of diagnostic testing.

DIAGnostic:TYPE Sets or returns the diagnostic type.

DIAGnostic:TYPE:CATalog? Returns a list of diagnostic types available depending on the end user.

DIAGnostic:UNSelect Unselects one or more tests of the current test list.

Display group commands

Use the display commands to adjust the display plot area.

Table 2-15: Display group commands and their descriptions

Command Description

DISPlay[:PLOT][:STATe]

Minimizes or restores the plot’s display area on the Home screen's channel window of the AWG.

AWG5200 Series Programmer Manual 2-19

Command groups

Function generator group commands

Use the function generator commands to generate basic waveshapes.

Table 2-16: Function generator group commands and their descriptions

Command Description

FGEN:[CHANnel[n]]:AMPLitude:POWer Sets or returns the function generator’s waveform amplitude value of the

speciﬁed channel in units of dBm.

FGEN[:CHANnel[n]]:AMPLitude[:VOLTage] Sets or returns the amplitude of the generated waveform of the selected

channel in units of volts.

FGEN[:CHANnel[n]]:DCLevel Sets or returns the DC level of the generated waveform of the selected

channel.

FGEN[:CHANnel[n]]:FREQuency Sets or returns the frequency of the generated waveform.

FGEN[:CHANnel[n]]:HIGH Sets or returns the generated waveform's high voltage value of the

selected channel.

FGEN[:CHANnel[n]]:LOW Sets or returns the generated waveform's low voltage value of the selected

channel.

FGEN[:CHANnel[n]]:OFFSet Sets or returns the offset of the generated waveform of the selected

channel.

FGEN[:CHANnel[n]]:PAT H Sets or returns the function generator’s signal path for the speciﬁed

channel.

FGEN[:CHANnel[n]]:PERiod? Returns the generated waveform's period.

FGEN[:CHANnel[n]]:PHASe Sets or returns the generated waveform's phase of the selected channel.

FGEN[:CHANnel[n]]:SYMMetry Sets or returns the generated waveform's symmetry value of the selected

channel.

FGEN[:CHANnel[n]]:TYPE Sets or returns the waveform type (shape) of the selected channel.

IEEE mandated and optional group commands

All AWG IEEE mandated and optional command implementations are based on

he SCPI standard and the speciﬁcations for devices in IEEE 488.2.

Table 2-17: IEEE mandated and optional group commands and their descriptions

Command Description

*CAL? Runs all self calibrations and returns the result. Same as CALibration[:ALL].

*CLS Clears all event registers and queues.

*ESE Sets or returns the Event Status Enable Register (ESER).

*ESR? Returns the current contents of the Event Status Register (ESR).

*IDN? Returns identiﬁcation information for the AWG.

2-20 AWG5200 Series Programmer Manual

Command groups

Table 2-17: IEEE mandated and optional group commands and their descriptions (cont.)

Command Description

*OPC This command causes the AWG to sense the internal ﬂag referred to as

the “No-Operation-Pending” ﬂag. The command sets bit 0 in the Standard Event Status Register when pending operations are complete.

The query form returns a “1” when the last overlapping command operation is ﬁnished.

*OPT? Returns the implemented options for the AWG.

*RST Resets the AWG to its default state.

*SRE Sets or returns the bits in the Service Request Enable Register (SRER).

*STB? Returns the contents of Status Byte Register (SBR).

*TRG Generates a trigger event for Trigger A only.

*TST? Executes a power-on self test and returns the results.

*WAI Ensures the completion of the previous command before the next

command is issued.

Instrument group commands

Use the instrument commands to set the coupled state and set the mode (function mode or arbitrary waveform generator mode).

Table 2-18: Instrument group commands and their descriptions

Command Description

INSTrument:COUPle:SOURce Sets or returns the coupled state of the channel’s Analog and Marker

output controls.

INSTrument:MODE Sets or r eturns the operating mode (AWG mode or the Function generator

mode).

Mass memory group commands

Use the mass memory commands to read/write data from/to hard disk on the instrument.

Commands noted for backwards compatibility should not be used for new programming applications.

Table 2-19: Mass memory group commands and their descriptions

Command Description

MMEMory:CATalog? Returns the current contents and state of the mass storage media.

MMEMory:CDIRectory Sets or returns the current directory of the ﬁle system on the AWG.

MMEMory:DATA

Sets or returns block data to/from ﬁle in the current mass storage device.

AWG5200 Series Programmer Manual 2-21

Command groups

Table 2-19: Mass memory group commands and their descriptions (cont.)

Command Description

MMEMory:DATA:SIZE? Returns the size in bytes of a selected ﬁle.

MMEMory:DELete

MMEMory:IMPort

Deletes a ﬁle or directory from the AWG's hard disk.

NOTE. This command exists for backwards compatibility. Use the command MMEMory:OPEN.

Loads a ﬁle into the AWG waveform list.

MMEMory:IMPort[:PARameter]:NORMalize

NOTE. Th

is command exists for backwards compatibility. Use

the command MMEMory:OPEN[:PARameter]:NORMalize.

Sets or returns if the imported data is normalized during select ﬁle format import operations. The imported waveform data (for select ﬁle formats) is normalized based on the option set in this command.

MMEMory:MDIRectory

MMEMory:MSIS Sets or returns a mass storage device used by all MMEMory commands.

MMEMory:OPEN Loads a ﬁle into the AWG waveform list.

MMEMory:OPEN[:PARameter]:NORMalize Sets or returns if the imported data is normalized during select ﬁle format

MMEMory:OPEN[:PARameter]:SIQ Sets or returns if the IQ waveform (from supported formats) i s separated

MMEMory:OPEN:SASSet:SEQuence Loads all sequences or a single desired sequence from a ﬁle into the

MMEMory:OPEN:SASSet:SEQuence:MROPened? Returns which sequence was most recently added or replaced from the

MMEMory:OPEN:SASSet[:WAVeform] Loads all waveforms or a s ingle desired waveform from a ﬁle into the

MMEMory:OPEN:SETup Opens a setup ﬁle into the AWG’s setup memory.

MMEMory:OPEN:TXT Loads a ﬁle into the AWG’s waveform list.

MMEMory:SAVE:SEQuence

MMEMory:SAVE:SETup Saves the AWG's setup and optionally includes the waveforms.

MMEMory:SAVE[:WAVeform]:MAT Exports a waveform given a unique waveform name to an eligible storage

MMEMory:SAVE[:WAVeform]:TIQ Exports a waveform given a unique waveform name to an eligible storage

MMEMory:SAVE[:WAVeform]:TXT Exports a waveform given a unique waveform name to an eligible storage

MMEMory:SAVE[:WAVeform]:WFM Exports a waveform given a unique waveform name to an eligible s torage

MMEMory:SAVE[:WAVeform][:WFMX] Exports a waveform given a unique waveform name to an eligible s torage

Creates a new directory in the current path on the mass storage system.

import operations.

into two separate _I and _Q waveforms while importing.

AWG’s sequences list.

most recently opened or imported sequence ﬁle.

AWG’s waveforms list.

Exports a sequence given a unique name to an eligible storage location as the .SEQX ﬁle type.

location from the AWG’s waveforms with the AWG Speciﬁc MATLAB ﬁle format (MAT 5).

location from the AWG’s waveforms as the .TIQ ﬁle type.

location from the AWG’s waveforms as the .TXT ﬁle type.

location from the AWG’s waveforms as the .WFM ﬁle type.

location from the AWG’s waveforms as the .WFMX ﬁle type.

2-22 AWG5200 Series Programmer Manual

Command groups

Output group c

ommands

Use the output commands to set or return the characteristics of the output of the arbitrary waveform generator.

Table 2-20: Output group commands and their descriptions

Command Description

OUTPut:OFF Sets or returns the state (enabled or disabled) of the 'All Outputs Off'

control. Enabled causes each channel’s output and markers to go to an ungrounded (or open) state.

OUTPut[n]:PATH Sets or returns the output signal path of the speciﬁed channel.

OUTPut[n][:STATe] Sets or returns the output state of the speciﬁed channel.

OUTPut[n]:SVALue[:ANALog][:STATe] Sets or returns the output condition of a waveform of the speciﬁed channel

while the instrument is in the stopped state.

OUTPut[n]:SVALue:MARKer[m] Sets or returns the output condition of the speciﬁed marker of the speciﬁed

channel while the instrument is in the stopped state.

OUTPut[n]:WVALue[:ANALog][:STATe] Sets or returns the output condition of a waveform of the speciﬁed channel

while the instrument is in the waiting-for-trigger state.

OUTPut[n]:WVALue:MARKer[m] Sets or returns the output condition of the speciﬁed marker of the speciﬁed

channel while the instrument is in the waiting-for-trigger state.

S-Parameters group commands

Use these commands to control and apply the S-Parameter to waveforms.

Table 2-21: S-parameters group commands and their descriptions

Command Description

WLISt:SPARameter:APPLy Applies S-Parameters to a waveform that exists in the waveform list of

the current setup.

WLISt:SPARameter:BANDwidth Sets or returns the S-Parameter bandwidth value when the bandwidth is

set to use a manual entry.

WLISt:SPARameter:BANDwidth:AUTO Sets or returns how the S-Parameter bandwidth is deﬁned.

WLISt:SPARameter:CASCading:AGGRessor2[: ENABle]

WLISt:SPARameter:CASCading:AGGRessor[n]: AMPLitude

WLISt:SPARameter:CASCading:AGGRessor[n]: CTALk

WLISt:SPARameter:CASCading:AGGRessor[n]: DRATe

WLISt:SPARameter:CASCading:AGGRessor[n]: SIGNal

Sets or returns whether the aggressor 2 signal type state (enabled or disabled) in Cascading mode. Aggressor2 signals are available when the number of ports is set to 12.

Sets or returns the speciﬁed Aggressor's amplitude, in Cascading mode.

Sets or returns the speciﬁed Aggressor's crosstalk type, in Cascading mode.

Sets or returns the speciﬁed Aggressor's data rate, in Cascading mode.

Sets or returns speciﬁed Aggressor's signal type, in Cascading mode.

AWG5200 Series Programmer Manual 2-23

Command groups

Table 2-21: S-parameters group commands and their descriptions (cont.)

Command Description

WLISt:SPARameter:CASCading:AGGRessor[n]: SIGNal:FILE

WLISt:SPARameter:CASCading:AGGRessor[n]: SIGNal:PRBS

WLISt:SPARameter:CASCading:DEEMbed Sets or returns whether the C ascading S-Parameters is to de-embed

WLISt:SPARameter:CASCading:STAGe[m]:DRX[n] Sets or returns the S-Parameter port assignment of the speciﬁed Stage

WLISt:SPARameter:CASCading:STAGe[m]:DTX[n] Sets or returns the S-Parameter port assignment of the speciﬁed Stage and

WLISt:SPARameter:CASCading:STAGe[m]:ENABle Sets or returns the state of the speciﬁed Cascaded S-Parameter stage

WLISt:SPARameter:CASCading:STAGe[m]:FILE Sets or returns the Filepath for the speciﬁed S-Parameters Cascading

WLISt:SPARameter:CASCading:STAGe[m]:RX[n] Sets or returns the S-Parameter port assignment of the speciﬁed Stage

WLISt:SPARameter:CASCading:STAGe[m]:SSCHeme Sets or returns the S-Parameter Signalling S cheme, in Cascading mode.

WLISt:SPARameter:CASCading:STAGe[m]:TX[n] Sets or returns the S-Parameter port a ssignment of the speciﬁed Stage and

WLISt:SPARameter:CASCading:STYPe Sets or returns S-Parameter signal type (victim or aggressor), in Cascading

WLISt:SPARameter:CASCading:TYPE Sets or returns the S-Parameter number of ports, in Cascading mode.

WLISt:SPARameter:MODE Sets or returns the S-Parameter mode (Cascading or Non-Cascading).

WLISt:SPARameter:NCAScading:AGGRessor2[: ENABle]

WLISt:SPARameter:NCAScading:AGGRessor[n]: AMPLitude

WLISt:SPARameter:NCAScading:AGGRessor[n]: CTALk

WLISt:SPARameter:NCAScading:AGGRessor[n]: DRATe

WLISt:SPARameter:NCAScading:AGGRessor[n]: SIGNal

WLISt:SPARameter:NCAScading:AGGRessor[n]: SIGNal:FILE

Sets or returns the ﬁlepath to the aggressor ﬁle for the speciﬁed Aggressor, in Cascading mode.

Sets or returns the speciﬁed Aggressor's PRBS s ignal type, in Cascading mode.

(invert) the S-Parameters, in Cascading mode.

and the channel’s speciﬁed receiver port number (Rx-Port) in Cascading mode and Differential Signalling Scheme (where applicable).

the channel’s speciﬁed transmission port number (Tx-Port) in Cascading mode and Differential Signalling Scheme (where applicable).

(enabled or disabled).

Stage, in Cascading mode.

and the channel’s speciﬁed receiver port number (Rx-Port) in Cascading mode and Single-Ended Signalling Scheme (where applicable).

Signalling Scheme is only available when the Number of Ports is set to 4, 8, or 12.

the channel’s speciﬁed transmission port number (Tx-Port) in Cascading mode and Single-Ended Signalling Scheme (where applicable).

mode. The number of ports must be either 8 or 12.

Sets or returns the aggressor 2 signal type state (enabled or disabled) in Non-Cascading mode. Aggressor2 signals are available when the number of ports is set to 12.

Sets or returns the speciﬁed Aggressor's amplitude, in Non-Cascading mode.

Sets or returns the speciﬁed Aggressor's crosstalk type, in Non-Cascading mode.

Sets or returns the speciﬁed Aggressor's data rate, in Non-Cascading mode.

Sets or returns speciﬁed Aggressor's signal type, in Non-Cascading mode.

Sets or returns the ﬁlepath to the aggressor ﬁle for the speciﬁed Aggressor, in Non-Cascading mode.

2-24 AWG5200 Series Programmer Manual

Command groups

Table 2-21: S-parameters group commands and their descriptions (cont.)

Command Description

WLISt:SPARameter:NCAScading:AGGRessor[n]: SIGNal:PRBS

WLISt:SPARameter:NCAScading:DEEMbed Sets or returns whether the Non-Cascading S-Parameters is to de-embed

WLISt:SPARameter:NCAScading:DRX[n] Sets or returns the S-Parameter port assignment of the channel’s speciﬁed

WLISt:SPARameter:NCAScading:DTX[n] Sets or returns the S-P arameter port assignment of the channel’s

WLISt:SPARameter:NCAScading:FILE Sets or returns the ﬁlepath and ﬁle name of the S-Parameter ﬁle, in

WLISt:SPARameter:NCAScading:LAYout Sets or returns the 4 port S-Parameter Matrix Conﬁguration, in

WLISt:SPARameter:NCAScading:RX[n] Sets or returns the S-Parameter port assignment of the channel’s speciﬁed

WLISt:SPARameter:NCAScading:SSCHeme Sets or returns the S-Parameter Signalling Scheme, in Non-Cascading

WLISt:SPARameter:NCAScading:STYPe Sets or returns S-Parameter signal type (victim or aggressor), in

WLISt:SPARameter:NCAScading:TX[n] Sets or returns the S-Parameter port assignment of the channel’s

WLISt:SPARameter:NCAScading:TYPE Sets or returns the S-Parameter number of ports, in Non-Cascading mode.

WLISt:SPARameter:SFORmat Sets or returns the currently used signal format for setting the S-Parameter

Sets or returns the speciﬁed Aggressor's PRBS signal type, in Non-Cascading mode.

(invert) the S-Parameters, in Non-Cascading mode.

receiver port number (Rx-Port) in Non-Cascading mode and Differential Signalling Scheme (where applicable).

speciﬁed transmission port number (Tx-Port) in Non-Cascading mode and Differential Signalling Scheme (where applicable).

Non-Cascading mode.

receiver port number (Rx-Port) in Non-Cascading mode and Single-Ended Signalling Scheme (where applicable).

mode. Signalling Scheme is only available when the N umber of Ports issetto4,8,or12.

Non-Cascading mode. The number of ports must be either 8 or 12.

speciﬁed transmission port number (Tx-Port) in Non-Cascading mode and Single-Ended Signalling Scheme (where applicable).

values.

Sequence group commands

Use the sequence commands to deﬁne create and deﬁne waveform sequences and subsequences.

Table 2-22: Sequence group commands and their descriptions

Command Description

SLISt:NAME? Returns the name of the sequence corresponding to the speciﬁed index

in the sequence list.

SLISt:SEQuence:AMPLitude Sets or returns the Recommended Amplitude (peak-to-peak) of the

speciﬁed sequence.

SLISt:SEQuence:DELete Deletes a speciﬁc sequence or all sequences from the sequence list.

AWG5200 Series Programmer Manual 2-25

Command groups

Table 2-22: Sequence group commands and their descriptions (cont.)

Command Description

SLISt:SEQuence:EVENt:JTIMing Sets or returns the jump timing of a sequence.

SLISt:SEQuence:EVENt:PJUMp:DEFine Sets or returns the pattern jump targets in the pattern jump table.

SLISt:SEQuence:EVENt:PJUMp:ENABle Sets or returns the pattern jump for a sequence.

SLISt:SEQuence:EVENt:PJUMp:SIZE? Returns number of patterns in the pattern table.

SLISt:SEQuence:FREQuency Sets or returns the recommended frequency of the speciﬁed sequence

when the sequence contains IQ waveforms.

SLISt:SEQuence:LENGth? Returns the total number of steps in the named sequence.

SLISt:SEQuence:NEW Creates a new sequence.

SLISt:SEQuence:OFFSet Sets or returns the Recommended Offset of the speciﬁed sequence.

SLISt:SEQuence:RFLag Sets or returns the Enable Flag Repeat value for the sequence.

SLISt:SEQuence:SRATe Sets or returns the Recommended Sampling Rate of the speciﬁed

sequence.

SLISt:SEQuence:STEP:ADD

SLISt:SEQuence:STEP:MAX? Returns the maximum number of steps allowed in a sequence.

SLISt:SEQuence:STEP:RCOunt:MAX? Returns the maximum number of repeats allowed for a step in a sequence.

SLISt:SEQuence:STEP[n]:EJINput Sets or returns weather the sequence of play w ill jump when it receives

SLISt:SEQuence:STEP[n]:EJUMp Sets or returns the step that the sequence of play will jump to on a trigger

SLISt:SEQuence:STEP[n]:GOTO Sets or returns the Goto target for a step.

SLISt:SEQuence:STEP[n]:RCOunt Sets or returns the repeat count.

SLISt:SEQuence:STEP[n]:TASSet:SEQuence Assigns a subsequence for a speciﬁc sequence's step and track.

SLISt:SEQuence:STEP[n]:TASSet[m]? Returns the name of the waveform assigned to a step.

SLISt:SEQuence:STEP[n]:TASSet[m]:TYPE? Returns the type of asset assigned at the step and track for a speciﬁed

SLISt:SEQuence:STEP[n]:TASSet[m]:WAVeform Assigns a waveform to the speciﬁed track of a step.

SLISt:SEQuence:STEP[n]:TFLag[m]:AFLag Sets or returns the Flag A value of the track in a sequence step.

SLISt:SEQuence:STEP[n]:TFLag[m]:BFLag Sets or returns the Flag B value of the track in a sequence step.

SLISt:SEQuence:STEP[n]:TFLag[m]:CFLag Sets or returns the Flag C value of the track in a s equence step.

SLISt:SEQuence:STEP[n]:TFLag[m]:DFLag Sets or returns the Flag D value of the track in a s equence step.

SLISt:SEQuence:STEP[n]:WINPut Sets or returns the wait input for a step.

SLISt:SEQuence:TRACk? Returns the total number of tracks in the named sequence.

SLISt:SEQuence:TRACk:MAX? Returns the maximum number of tracks allowed in a sequence.

SLISt:SEQuence:TSTamp? Returns the timestamp of the named sequence.

SLISt:SEQuence:WMUSage? Returns the total waveform memory usage (in sample points) for the

SLISt:SIZE? Returns the number of sequences in the sequence list.

Adds steps to an existing sequence.

Trigger A, Trigger B, or not jump at all.

event.

sequence.

speciﬁed sequence track for the named sequence.

2-26 AWG5200 Series Programmer Manual

Command groups

Source group c

ommands

Use the source commands to deﬁne the waveform and marker outputs and parameters.

Commands noted for backwards compatibility should not be used for new programming applications.

Table 2-23

Command Description

[SOURce:]FREQuency[:CW]|[:FIXed] Sets or returns the clock sample rate of the AWG.

: Source group commands and their descriptions

NOTE. This command e xists for backwards compatibility. Use the command CLOCk:SRATe.

[SOURce[n]:]POWer[:LEVel][:IMMediate][:AMPLitude] Sets or returns the amplitude for the waveform associated with the

d channel in units of dBm.

speciﬁe

[SOURc

[SOURce:]ROSCillator:MULTiplier Sets or returns the multiplier of the external reference oscillator.

e:]RCCouple

returns the Coupled state (enabled or disabled) of the Run Mode

Sets or control. The Run controls consist of the Run Mode and Trigger Input.

NOTE. This command e xists for backwards compatibility. Use the command CLOCk:EREFerence:MULTiplier.

[SOURce[n]:]CASSet:CLEar This command removes the asset (waveform or sequence) from the

iﬁed channel.

spec

URce[n]:]CASSet?

[SO

URce[n]:]CASSet:CLEar

[SO

OURce[n]:]CASSet:TYPE?

[SOURce[n]:]CASSet:WAVeform Assigns a waveform to a channel.

[SOURce[n]:]CFRequency Sets or returns the center frequency for the IQ waveform associated with

[SOURce[n]:]DAC:RESolution Sets or returns the DAC resolution.

[SOURce[n]:]DDR Sets or returns the DDR (2x interpolation) state (enabled or disabled) for

[SOURce[n]:]DMODe Sets or returns DAC output mode type for the speciﬁed channel.

[SOURce:]IQIMode Sets or returns the Baseband IQ Interpolation mode. IQ Interpolation mode

[SOURce[n]]:JUMP:FORCe Forces the sequencer to jump to the speciﬁed step for the speciﬁed

[SOURce[n]]:JUMP:PAT Tern:FORCe Generates an event forcing the sequencer to the step speciﬁed by pattern

[SOURce[n]:]MARKer[m]:DELay Sets or returns the marker delay.

[SOURce[n]:]MARKer[m]:VOLTage[:LEVel][: IMMediate][:AMPLitude]

urns the waveform or sequence name assigned to a channel.

Ret

Assigns a sequence to a channel.

turns the type of the asset (waveform or sequence) assigned to a

Re channel.

the speciﬁed channel. Option DIGUP (Digital Up Converter) is required.

the speciﬁed channel.

is coupled for all channels.

channel.

in the pattern jump table.

Sets or returns the marker amplitude.

AWG5200 Series Programmer Manual 2-27

Command groups

Table 2-23: Source group commands and their descriptions (cont.)

Command Description

[SOURce[n]:]MARKer[m]:VOLTage[:LEVel][: IMMediate]:HIGH

[SOURce[n]:]MARKer[m]:VOLTage[:LEVel][: IMMediate]:LOW

[SOURce[n]:]MARKer[m]:VOLTage[:LEVel][: IMMediate]:OFFSet

[SOURce[n]:]RMODe Sets or returns the run mode of the AWG.

[SOURce[n]:]SCSTep? Returns the current step of the sequence while system is running.

[SOURce[n]:]SDCorrection Sets or returns the sin(x)/x c orrection state (enabled or disabled) for the

[SOURce[n]:]SKEW Sets or returns the skew (relative timing of the analog output) for the

[SOURce[n]:]TINPut Sets or returns the trigger input source.

[SOURce[n]:]VOLTage[:LEVel][:IMMediate][: AMPLitude]

[SOURce[n]:]VOLTage[:LEVel][:IMMediate]:BIAS Sets or returns the Bias (for AC output paths) for the waveform associated

[SOURce[n]:]VOLTage[:LEVel][:IMMediate]:BIAS: ENABle

[SOURce[n]:]VOLTage[:LEVel][:IMMediate]:HIGH Sets or returns the high voltage level for the waveform associated with

[SOURce[n]:]VOLTage[:LEVel][:IMMediate]:LOW Sets or returns the low voltage level for the waveform associated with a

[SOURce[n]:]VOLTage[:LEVel][:IMMediate]:OFFSet Sets or returns the Offset (for DC output paths) for the waveform associated

[SOURce[n]:]WAVeform Sets or returns the name of the waveform assigned to a c hannel.

Sets or returns the marker high level.

Sets or returns the marker low level.

Sets or returns the marker offset.

speciﬁed channel.

waveform associated with the speciﬁed channel.

Sets or returns the amplitude for the waveform associated with a channel in units of volts.

with the speciﬁed channel.

Sets or returns the state (enabled or disabled) of the Bias control. When enabled, a bias level can be added to the output. The Output Path must be set to one of the AC output paths.

the speciﬁed channel.

The value is affected by the Offset setting (for DC modes) or the Bias setting (for AC modes).

channel.

The value is affected by the Offset setting (for DC modes) or the Bias setting (for AC modes).

with the speciﬁed channel.

NOTE. This command exists for backwards compatibility. See the command description for preferred commands.

2-28 AWG5200 Series Programmer Manual

Command groups

Status group c

ommands

The external controller uses the status commands to coordinate operation between the AWG and other devices on the bus. The status commands set and query the registers/q

ueues of the AWG event/status reporting system. For more information

about registers and queues, see the Status and Event reporting section.

Table 2-24: Status group commands and their descriptions

Command Description

STATus:OPERation:CONDition? Returns the contents of the Operation Condition Register (OCR).

STATus:OPERation:ENABle Sets or returns the mask for the Operation Enable Register (OENR).

STATus:OPERation[:EVENt]? Returns the contents of Operation Event Register (OEVR).

STATus:OPERation:NTRansition Sets or returns the negative transition ﬁlter value of the Operation

ion Register (OTR).

Transit

:OPERation:PTRansition

STATus

STATus:PRESet Sets the OENR and QE NR registers.

STATus:QUEStionable:CONDition? Returns the status of the Questionable Condition Register (QCR).

STATus:QUEStionable:ENABle Sets or returns the mask for Questionable Enable Register (QENR).

STATus:QUEStionable[:EVENt]? Returns the contents of the Questionable Event (QEVR) Register and

STATus:QUEStionable:NTRansition Sets or returns the negative transition ﬁlter value of the Questionable

ATus:QUEStionable:PTRansition

returns the positive transition ﬁlter value of the Operation Transition

Sets or Register (OTR).

clears it.

nsition Register (QTR).

Tra

ts or returns the positive transition ﬁlter value of the Questionable

Se Transition Register (QTR).

ynchronization group commands

Use the synchronization commands to enable synchronizing AWG5200 series instruments together in a synchronized system.

Table 2-25: Synchronization group commands and their descriptions

Command Description

SYNChronize:ENABle Sets o r returns the synchronization state (enabled or disabled). When

enabled, the instrument can be used as part of a synchronized system of other AWG5200 series instruments.

SYNChronize:TYPE This command sets or returns the instrument type (master or slave) when

synchronization is enabled.

AWG5200 Series Programmer Manual 2-29

Command groups

System group c

ommands

Use the system commands to control miscellaneous instrument functions and obtain instrument information.

Table 2-26:

Command Description

SYSTem:DATE Sets or returns the system date.

SYSTem:ERRor:ALL? Returns the error and event queue for all the unread items and removes

SYSTem:ERRor:CODE:ALL? Returns the error and event queue for the codes of all the unread items

SYSTem:

SYSTem:ERRor:COUNt? Returns the error and event queue for the number of unread items.

SYSTem:ERRor:DIALog Sets or returns the error dialog display status.

SYSTem:ERRor[:NEXT]? Returns data from the error and event queue.

SYSTem:TIME Sets or returns the system time.

SYSTem:VERSion? Returns the SCPI version number to which the command conforms.

System group commands and their descriptions

them from the queue.

and remov

ERRor:CODE[:NEXT]?

Returns the queue.

es them from the queue.

the error and event queue for the next item and removes it from

2-30 AWG5200 Series Programmer Manual

Trigger group commands

Use the trigger commands synchronize the arbitrary waveform generator actions with events.

Commands noted for backwards compatibility should not be used for new programming applications.

Table 2-27: Trigger group commands and their descriptions

Command groups

Command Descriptio

ABORt Stops wave

equivalent to releasing the Force Trig button on the front panel when the instrument is in gated mode.

TRIGger[:IMMediate] Generates a trigger event.

TRIGger:IMPedance Sets or returns the impedance of the external triggers.

TRIGger:INTerval Sets or returns the internal trigger interval.

TRIGger:LEVel Sets or returns the external trigger input levels (threshold).

TRIGger:MODE Sets or returns the trigger timing used when an external trigger source is

being

er:SLOPe

TRIGg

TRIG

ger:SOURce

Sets o

Sets

form playout when the Run Mode is set to Gated. This is

used.

r returns the external trigger slopes.

or returns the trigger source.

NOTE. This command e xists for backwards compatibility. Use the command [SOURce[n]:]TINPut.

TRIGger:WVALue Sets or returns the output data position of a waveform while the instrument

is in the waiting-for-trigger state

NOTE. This command e xists for backwards compatibility.

e the commands OUTPut[n]:WVALue[:ANALog][:STATe]

Us and OUTPut[n]:WVALue:MARKer[m].

Waveform group commands

Use the waveform commands to create and transfer waveforms between the instrument and the external controller.

Table 2-28: Waveform group commands and their descriptions

Command Description

WLISt:LAST? Returns the name of the most recently added waveform in the waveform

list.

WLISt:LIST? Returns a list of all waveform names in the waveform list.

WLISt:NAME? Returns the waveform name of an element in the waveform list.

WLISt:SIZE? Returns the size of the waveform list.

AWG5200 Series Programmer Manual 2-31

Command groups

Table 2-28: Waveform group commands and their descriptions (cont.)

Command Description

WLISt:WAVeform:ACFile Applies user supplied correction coefﬁcients from an external

(precompensation) ﬁle to the speciﬁed waveform (or waveforms).

WLISt:WAVeform:ACFile:GAUSsian Sets or returns whether a gaussian ﬁlter will be applied during the

application of a precompensation ﬁle (correction coefﬁcients ﬁle).

WLISt:WAVeform:ACFile:GAUSsian:BANDwidth Sets or returns the bandwidth of the gaussian ﬁlter that is to be applied

during application of a precompensation ﬁle (correction coefﬁcients ﬁle).

WLISt:WAVeform:ACFile:RSINc Sets or returns whether or not corrections for Sin(x)/x distortions will be

removed during application of a correction ﬁle.

WLISt:WAVeform:ACFile:SKEW Sets or returns whether the measured Skew will be applied during

application of a precompensation ﬁle (correction coefﬁcients ﬁle).

WLISt:WAVeform:AMPLitude Sets or returns the Recommended Amplitude (peak-to-peak) of the

speciﬁed waveform.

WLISt:WAVeform:DATA Transfers analog waveform data from the external controller into the

speciﬁed waveform or from a waveform to the external control program.

WLISt:WAVeform:DATA:I Transfers I waveform data from the external controller into the speciﬁed

waveform or from a waveform to the external control program.

WLISt:WAVeform:DATA:Q Transfers Q waveform data from the external controller into the speciﬁed

waveform or from a waveform to the external control program.

WLISt:WAVeform:DELete Deletes the waveform from the currently loaded setup.

WLISt:WAVeform:FREQuency Sets or returns the Recommended Center Frequency of the named IQ

waveform.

WLISt:WAVeform:GRANularity? Returns the granularity of sample points required for the waveform to be

valid.

WLISt:WAVeform:INVert Inverts the named waveform (in the waveform list).

WLISt:WAVeform:LENGth? Returns the size of the waveform.

WLISt:WAVeform:LMAXimum? Returns the maximum number of waveform sample points allowed.

WLISt:WAVeform:LMINimum? Returns the minimum number of waveform sample points required for a

valid waveform.

WLISt:WAVeform:MARKer:DATA Sets or returns the waveform marker data.

WLISt:WAVeform:MIQ Creates an IQ waveform from two real waveforms.

WLISt:WAVeform:NEW Creates a new empty waveform in the waveform list of current setup.

WLISt:WAVeform:NO RMalize Normalizes a waveform that exists in the waveform list.

WLISt:WAVeform:OFFSet Sets or returns the Recommended Offset of the speciﬁed waveform.

WLISt:WAVeform:RESample Resamples a waveform that exists in the waveform list.

WLISt:WAVeform:RE Verse Reverses the order of the named waveform (in the waveform list).

WLISt:WAVeform:ROTate Rotates the named waveform (in the waveform list).

WLISt:WAVeform:SFORmat Sets or returns the signal format listed as part of the properties of the

speciﬁed waveform.

WLISt:WAVeform:SHIFt Shifts the phase of a waveform that exists in the waveform l ist.

2-32 AWG5200 Series Programmer Manual

Command groups

Table 2-28: Waveform group commands and t heir descriptions (cont.)

Command Description

WLISt:WAVeform:SRATe Sets or returns the R ecommended Sampling R ate of the speciﬁed

waveform.

WLISt:WAVeform:TSTamp? Returns the timestamp of the waveform.

WLISt:WAVeform:TYPE? Returns the type of the waveform.

NOTE. This command exists for backwards compatibility.

Waveform data format

The AWG supports the Floating Point format of waveform data.

Floating data format is the same as the IEEE 754 single precision format. It occupies 4 bytes per waveform data point. It stores normalized data without any scaling. When the waveform in real data format is output, the data is rounded off to the nearest integer value and clipped to ﬁt the DAC range.

The waveforms in the real format retains normalized values. The format for the waveform analog data in the real format is IEEE754 single precision.

The real data format is shown in the following table.

Table 2-29: Real data format

e offset 3

Byt

E754 single precision format (32 bits)

IEE

e offset 2

Byt

e offset 1

Byt

eoffset0

Byt

DAC resolution affects the way hardware interprets the bits in the waveform. Therefore it is necessary t o reload waveforms once the DAC resolution is modiﬁed. To understand how to change the DAC resolution, see the

[SOURce[n]:]DAC:RESolution command. To understand how to load a

waveform into hardware memory, see the [SOURce[n]:]WAVeform command.

Byte order during transfer

Waveform data is always transferred in LSB ﬁrst format.

Waveform plug-in group commands

Use the waveform plug-in commands to set the active waveform plug-in.

Table 2-30: Waveform plug-in group commands and their descriptions

Command Description

WPLugin:ACTive Sets or returns the active waveform c reation plug-in.

WPLugin:PLUGins? Returns all the available waveform creation plug-ins.

AWG5200 Series Programmer Manual 2-33

Command groups

2-34 AWG5200 Series Programmer Manual

Command descriptions

This section contains all available commands. They are presented in alphabetical order.

Use the Command Groups section to simplify navigating to speciﬁc groups of commands.

ABORt (No Query Form)

This command stops waveform playout when the Run Mode is set to Gated. This is equivalent to releasing the Force Trig button on the front panel when the instrument is in gated mode.

Conditions

Group

Syntax

Related Commands

Arguments

Examples

This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Trigger

ABORt [{ATRigger|BTRigger}]

[SOURce[n]:]RMODe

ATRigger: Aborts waveform playout for all channels with the Run Mode set to Gated and Trigger set to A.

Rigger: Aborts waveform playout for all channels with the Run Mode set

BT to Gated and Trigger set to B.

efaults to trigger A if not speciﬁed.

ABORT ATRIGGER stops the waveform playout on all channels with their Run

Mode set to Gated and Trigger set to A.

AWG5200 Series Programmer Manual 2-35

Command descriptions

ACTive:MODE

This command enables and disables access to diagnostics or calibration. When the active mode is DIAGnostic or CALibration, all other non-diagnostic and non-calibra

If a test or procedure is in progress, errors are not returned; they are added to the system e For example:

tion commands are ignored and no action occurs.

rror queue, which can be accessed with SYSTem:ERRor[:NEXT]?.

Conditions

-200, "[D|

-300,"Device-speciﬁc error; Diagnostics tests still in progress - act:mode diag"

-300,"Device-speciﬁc error; Calibration procedures still in progress act:mode cal"

To avoid this error, use the command DIAGnostic:STOP:STATe? or

CALibration:STOP:STATe? to test for this condition.

This command blocks when changing any state. Changing the state to NORMal causes a hardware initialization process and any related system settings are

red.

resto

If any diagnostic tests are in progress, then the request to change the active mode

s and the mode will not change.

fail

When changing the active mode, it’s recommended to follow the action with an

ration complete command (*OPC) to ensure the command has ﬁnished before

ope other commands are processed.

This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping commands.)

C] are still running;"

Group

Syntax

Related Commands

Arguments

2-36 AWG5200 Series Programmer Manual

Diagnostic

ACTive:MODE {NORMal|CALibration|DIAGnostic} ACTive:MODE?

DIAGnostic:ABORt, DIAGnostic:STOP, CALibration:ABORt

NORMal disables any active state for either calibration or diagnostics. When

entering the activ previous system state is restored and waveform playout is set to off.

CALibration enab

of calibration turns waveform playout off.

e state of normal, the hardware is set to a default state and the

les the active state for the calibration. Entering the active state

Command descriptions

Returns

Examples

DIAGnostic ena

bles the active state for the diagnostics. Entering the active state

of diagnostics turns waveform playout off.

*RST sets this

to NORM.

NORM CAL DIAG

ACTIVE:MODE DIAGNOSTIC enables the diagnostics mode.

ACTIVE:MODE? might return DIAG if in the diagnostics mode.

AWG5200 Series Programmer Manual 2-37

Command descriptions

AUXoutput[n]

Related Commands

Arguments

:SOURce

Group

Syntax

This command sets or returns the signal source for the speciﬁed Auxiliary Output connector.

Auxiliary output

AUXoutput[n]:SOURce {AFLag|BFLag|CFLag|DFLag} AUXoutput[n]:SOURce?

AUXoutput[n]:SOURce:CMAPping

AFLag (A Flag) BFLag (B Flag) CFLag (C Flag) DFLag (D Flag)

[n] determines the Auxiliary Output connector. If omitted, interpreted as 1.

Range of [n] is instrument dependent: AWG5202: 1 – 4 AWG5204: 1 – 4 AWG5208: 1 – 8

Returns

Examples

AFL (A sequencer ﬂag) BFL (B sequencer ﬂag) CFL (C sequencer ﬂag) DFL (D sequencer ﬂag)

AUXOUTPUT1:SOURCE AFLAG sets the Auxiliary 1 connector to output Sequencer

Flag A.

AUXOUTPUT2:SOURCE? might return CFL, indicating that the Auxiliary 2

connector is set to output Sequencer Flag C.

2-38 AWG5200 Series Programmer Manual

Command descriptions

AUXoutput[n]

Related Commands

Arguments

:SOURce:CMAPping

This command sets or returns the Auxiliary Output channel mapping.

Group

Syntax

Auxiliary output

AUXoutput[n]:SOURce:CMAPping <channel> AUXoutput[n]:SOURce:CMAPping?

AUXoutput[n]:SOURce

<channel>::={1|2} for AWG5202

<channel>::={1|2|3|4} for AWG5204

<channel>::={1|2|3|4|6|6|7|8} for AWG5208

[n] determines the Auxiliary Output connector. If omitted, interpreted as 1.

Range of [n] is instrument dependent: AWG5202: 1 – 4 AWG5204: 1 – 4 AWG5208: 1 – 8

Returns

Examples

A single <NR1> value.

AUXOUTPUT1:SOURCE:CMAPPING 2 maps channel 2 to the Auxiliary 1 output

connector.

AUXOUTPUT1:SOURCE:CMAPPING? might return 1, indicating that c hannel 1 is

mapped to the Auxiliary 1 output connector.

AWG5200 Series Programmer Manual 2-39

Command descriptions

AWGControl:A

Conditions

RSettings

This command sets or returns the state (enabled or disabled) of whether or not to apply the recommended settings of waveforms and sequences when they are assigned to a

When enabled, the system attempts to use the waveform’s recommended settings (sample rat This includes waveforms within sequence tracks assigned to a channel.

Recommend properties.

If the wa

If a recommended value is not included with the waveform, the current system values

Group

Syntax

Control

AWGControl:ARSettings {0|1|ON|OFF}

channel.

e, amplitude, and offset) when the waveform is assigned to a channel.

ed settings are deﬁned as part the waveform properties and sequence

veform is of an IQ type, the recommended frequency is also used.

remains unchanged.

ments

Argu

Returns

Examples

OFF or 0 causes the system to ignore the recommended settings. OFF or 0 is the default value.

ON or 1 causes the system to attempt to use the recommended settings.

A single <Boolean> value.

AWGCONTROL:ARSETTINGS ON applies the recommended settings when

waveforms are assigned to a channel.

AWGCONTROL:ARSETTINGS? might return 0, indicating that the recommended

settings will be ignored when waveforms are assigned to a channel.

2-40 AWG5200 Series Programmer Manual

Command descriptions

AWGControl[:

Condition

Related Commands

CLOCk]:DRATe

NOTE. This command exists for backwards compatibility. Use the command

CLOCk:ECLock:DIVider.

This command sets or returns the divider rate for the external clock.

Setting the clock divider rate forces the clock multiplier rate to a value of 1.

This is an overlapping command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Group

Syntax

Control

AWGControl[:CLOCk]:DRATe <NR1> AWGControl[:CLOCk]:DRATe?

CLOCk:ECLock:MULTiplier, CLOCk:SRATe, AWGControl[:CLOCk]:SOURce

Arguments

Returns

Examples

A single <NR1> value that is a power of 2.

Range: 1 to 2 (Where the maximum n value is the External Clock Rate/2n. The minimum n value is ≥ the minimum sample rate).

*RST sets this to 1.

A single <NR1> value.

AWGCONTROL:CLOCK:DRATE 4 *OPC?

sets the external clock divider rate to 4. The overlapping command is followed with an Operation Complete query.

AWGCONTROL:CLOCK:DRATE? might return 4.

AWG5200 Series Programmer Manual 2-41

Command descriptions

AWGControl:C

Conditions

Arguments

LOCk:PHASe[:ADJust]

NOTE. This command exists for backwards compatibility. Use the command

CLOCk:PHASe[:ADJust]:TIMe.

This command sets or returns the internal clock phase adjustment of the AWG.

This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Group

Syntax

Control

AWGControl:CLOCk:PHASe[:ADJust] <NR1> AWGControl:CLOCk:PHASe[:ADJust]?

A single <NR1> value.

Range: –8640 degrees to +8640 degrees.

Returns

Examples

A single <NR1> value.

AWGCONTROL:CLOCK:PHASE:ADJUST 100

sets the clock phase to 100 degrees.

AWGCONTROL:CLOCK:PHASE:ADJUST? might return 100, indicating the clock

phase is set to 100 degrees.

2-42 AWG5200 Series Programmer Manual

Command descriptions

AWGControl[:

Condition

Related Commands

CLOCk]:SOURce

NOTE. This command exists for backwards compatibility. Use the command

CLOCk:SOURce.

This command sets or returns the source of the clock.

This is an overlapping command. (See page 2-9, Sequential, blocking, and

overlapping commands.)

Group

Syntax

Control

AWGControl[:CLOCk]:SOURce {INTernal|EXTernal|EFIXed|EVARiable} AWGControl[:CLOCk]:SOURce?

CLOCk:SOURce

Arguments

Returns

Examples

INTernal – clock signal is generated internally and the reference frequency is

derived by the internal

EFIXed – clock is generated internally and the reference frequency is derived

oscillator.

from a ﬁxed 10 MHz reference supplied at the Reference In connector.

EVARiable – clock is generated internally and the reference frequency is derived

from a variable reference supplied at the Reference In connector.

EXTernal – clock signal supplied by the Clock In connector and the reference

frequency is derive

*RST sets this to INT.

INT EXT EFIXed EVAR

AWGCONTROL:CLO *OPC?

sets the clock source to internal. The overlapping command is followed

d from the internal precision oscillator.

CK:SOURCE INTERNAL

with an Operation Complete query.

AWGCONTROL:CLOCK:SOURCE? might return EXT, indicating that the clock

source is set to use the Clock In connector.

AWG5200 Series Programmer Manual 2-43

Command descriptions

AWGControl:C

Conditions

Arguments

Examples

OMPile (No Query Form)

This command compiles an equation ﬁle and imports the waveforms (created by the equation ﬁle) into the arbitrary waveform generator.

Only excepts equation ﬁles, with the ".equ" sufﬁx.

Group

Syntax

Control

AWGControl:COMPile <filename>

<ﬁlename>::= <string>

mes may include full and relative paths. If a path is not speciﬁed, then the

File na path of "C:\ProgramData\Tektronix\AWG\model\EquationEditor" is assumed. "model" is the model is the instrument family type.

AWGCONTROL:COMPILE “SIN.EQU” compiles the equation ﬁ le named “sin.equ”.

The default path is assumed.

AWGControl:CONFigure:CNUMber? (Query Only)

This command returns the number of channels available on the AWG.

Group

Syntax

Returns

Examples

Control

AWGControl:CONFi

A single <NR1> value.

AWGCONTROL:CONFIGURE:CNUMBER? might return 2.

gure:CNUMber?

2-44 AWG5200 Series Programmer Manual

Command descriptions

AWGControl:P

Arguments

Examples

JUMp:JSTRobe

This command sets or returns if the pattern jump is set (enabled or disabled) to always occur on the strobe signal. With this setting disabled, the pattern jump requiresast setting enabled, the pattern jump disregards the pattern address change condition, causing the jump to always occur on the strobe signal.

Group

Syntax

Returns

Control

AWGControl:PJUMp:JSTRobe {0|1|OFF|ON} AWGControl:PJUMp:JSTRobe?

OFF or 0: A jump requires both a strobe signal and an address change. ON or 1: Enables the Jump on Strobe Always condition; only requiring a strobe signal to jump.

A single Boolean value.

AWGCONTROL:PJUMP:JSTROBE ON enables the pattern jump to occur on every

strobe.

robe signal and a pattern address change to initiate a jump. With this

AWGCONTROL:PJUMP:JSTROBE? might return 0, indicating that pattern jump is

enabled.

AWG5200 Series Programmer Manual 2-45

Command descriptions

AWGControl:P

Arguments

Examples

JUMp:SEDGe

This command sets or returns the active Strobe Edge to use for Pattern Jump when Pattern Jump is ena bled for Sequencing.

Group

Syntax

Returns

Control

AWGControl:PJUMp:SEDGe {FALLing|RISing} AWGControl:PJUMp:SEDGe?

FALLing sets the falling edge of the strobe signal to the active edge. 256 input

patterns are available.

RISing sets the rising edge of the strobe signal to the active edge. 256 input

patterns are available.

FALL (Falling) RIS (Rising)

AWGCONTROL:PJUMP:SEDGE FALLING sets the pattern jump to occur on the

falling edge of the strobe signal.

AWGCONTROL:PJUMP:SEDGE? might return FALL, indicating the pattern jump

occurs on the falling edge of the strobe signal.

2-46 AWG5200 Series Programmer Manual

Command descriptions

AWGControl:R

Related Commands

Arguments

MODe

Group

Syntax

NOTE. This command exists for backwards compatibility. Use the command

[SOURce[n]:]RMODe.

This command sets or returns the run mode of the AWG for Channel 1.

Control

AWGControl:RMODe {CONTinuous|TRIGgered|GATed} AWGControl:RMODe?

[SOURce[n]:]RMODe

CONTinuous sets the Run Mo TRIGgered sets the Run Mode to Triggered, waiting for a trigger event. One

waveform play out cycle completes, then play out stops, waiting for the next trigger event.

GATed sets the Run Mode to only playout a waveform while the trigger is enabled.

de to Continuous (not waiting for a trigger event).

Returns

Examples

*RST setsthistoCONT.

CONT TRIG GAT

AWGCONTROL:RMODE TRIGGERED sets the Channel 1 Run mode to Triggered.

AWGCONTROL:RMODE? might return CONT, indicating that the Channel 1 Run

mode is set to Continuous.

AWG5200 Series Programmer Manual 2-47

Command descriptions

AWGControl:R

Related Commands

Examples

STate? (Query Only)

This command returns the run state of the AWG.

Group

Syntax

Returns

Control

AWGControl:RSTate?

[SOURce[n

A single <NR1> value.

0 indicates that the AWG has stopped. 1 indicates that the AWG is waiting for trigger. 2indic

AWGCONTROL:RSTATE? might return 0, indicating that waveform generation is

stopp

]:]RMODe

ates that the AWG is running.

ed.

AWGControl:RUN[:IMMediate] (No Query Form)

This command initiates the output of a waveform or sequence. This is equivalent

Conditions

Group

Syntax

Related Commands

Examples

to pushing the play button in the run state only when waveforms or se quences are assigned to channels.

This is an overlapping command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Control

AWGControl:RUN[:IMMediate]

AWGControl:STOP[:IMMediate]

AWGCONTROL:RUN:IMMEDIATE

puts the AWG in the run state.

on the front-panel or display. The AWG can be put

2-48 AWG5200 Series Programmer Manual

Command descriptions

AWGControl:S

Examples

NAMe? (Query Only)

This command returns the AWG's most recently saved setup location.

The response contains the full path for the ﬁle, including the disk drive letter (msus or, mass storage unit speciﬁer).

Group

Syntax

Returns

Control

AWGControl:SNAMe?

Returns <ﬁle_name>,<msus>

<ﬁle_na a<msus> (mass storage unit speciﬁer) ::= <string> By default (when there has been no save setup command), this value is "","C:"

AWGCONTROL:SNAME? might return the following response: "\my\project\setups\mySetup.awgx","D:"

me> ::= <string>

AWG5200 Series Programmer Manual 2-49

Command descriptions

AWGControl:S

Conditions

Related Commands

Arguments

REStore(NoQueryForm)

NOTE. This command exists for backwards compatibility. Use the command

MMEMory:OPEN:SETup.

This command opens a setup ﬁle into the AWG’s setup memory.

ocking command. (See page 2-9, Sequential, blocking, and overlapping

Group

Syntax

This is a bl commands.)

Control

AWGControl:SREStore <filepath>[,<msus>]

MMEMory:OPEN:SETup

<ﬁlepath>::=<string> <msus> (mass storage unit speciﬁer) ::=<string>

Examples

With mass storage unit speciﬁer speciﬁed as a parameter:

AWGCONTROL:SRESTORE "\TestFiles\mySetup.awgx","C:"

With mass storage unit speciﬁer speciﬁed within the ﬁle path:

AWGCONTROL:SRESTORE "C:\TestFiles\mySetup.awgx"

2-50 AWG5200 Series Programmer Manual

Command descriptions

AWGControl:S

Conditions

Related Commands

Arguments

SAVe (No Query Form)

NOTE. This command exists for backwards compatibility. Use the command

MMEMory:SAVE:SETup.

This command saves the AWG's setup with waveforms.

ocking command. (See page 2-9, Sequential, blocking, and overlapping

Group

Syntax

This is a bl commands.)

Control

AWGControl:SSAVe <filepath>[,<msus>]

MMEMory:SAVE:SETup

<ﬁlepath>::=<string> <msus> (mass storage unit speciﬁer)::=<string>

Examples

AWGCONTROL:SSAVE "C:\TestFiles\mySetup.awgx"

AWGCONTROL:SSAVE "\TestFiles\mySetup.awgx","C:"

AWG5200 Series Programmer Manual 2-51

Command descriptions

AWGControl:S

Conditions

Related Commands

Examples

TOP[:IMMediate] (No Query Form)

This command stops the output of a waveform or a sequence.

This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Group

Syntax

Control

AWGControl:STOP[:IMMediate]

AWGControl:RUN[:IMMediate]

AWGCON *OPC?

stops the output of a waveform or sequence.

TROL:STOP:IMMEDIATE

2-52 AWG5200 Series Programmer Manual

Command descriptions

BWAVeform:AM

Conditions

d Commands

Relate

PLitude

Group

Syntax

This command sets or returns the peak-to-peak Amplitude value for the waveform created by the Basic Waveform editor plug-in.

This setting can be affected if the system is set to use the full DAC range. Using the full DAC range is the default setting. Refer to the command

BWAVeform:

The amplitude settings for Offset, High, and Low voltage values can be affected by the Amp

Basic waveform editor

BWAVeform:AMPLitude <amplitude>

BWAVeform:OFFSet, BWAVeform:HIGH, BWAVeform:LOW BWAV

FDRange for more information.

litude setting.

eform:FDRange

Arguments

Returns

Examples

<amplitude>::= <NR3> value.

A single <NR3> value.

WAVEFORM:AMPLITUDE 200E-3

BWAVEFORM:AMPLITUDE? might return 500.0000000000E-3, indicating the

Amplitude for the compiled waveforms is set to 500 mV

sets the Amplitude to 200 mVpp.

AWG5200 Series Programmer Manual 2-53

Command descriptions

BWAVeform:AU

Conditions

Related Commands

Arguments

Group

Syntax

This command sets or returns the Basic Waveform editor plug-in Auto Calculate setting, determining which value is automatically calculated.

When the function is set to DC or Noise the options are: Length, Duration, or Sample Rate.

When the function is set to Sine, Square, Triangle, or Ramp the options are: Length, Cycle, Frequency, or Sample Rate.

Basic waveform e ditor

BWAVeform:AUTO {LEN|CYCLE|DUR|FREQ|SR} BWAVeform:AUTO?

BWAVeform:FUNCtion

LEN: Length is automatically calculated based on the other available waveform properties. CYCLE: Cycles is automatically calculated based on the other available waveform properties. DUR: Duration is automatically calculated based on the other available waveform properties. FREQ: Frequency is automatically calculated based on the other available waveform properties. SR: Sample Rate is automatically calculated based on the other available waveform properties.

*RST sets this to Cycle.

Returns

Examples

2-54 AWG5200 Series Programmer Manual

LEN: Length CYCLE: Cycle DUR: Duration FREQ: Frequency SR: Sample Rate

BWAVEFORM:AUTO LEN sets the Basic Waveform editor plug-in to automatically

calculate the waveform Length.

BWAVEFORM:AUTO? might return CYCLE, indicating that the Basic Waveform

editor plug-in is set to automatically calculate the number of Cycles.

Command descriptions

BWAVeform:CO

MPile (No Query Form)

This command initiates the Basic Waveform editor plug-in compile process. The created waveform is placed in the Waveform List.

Group

Syntax

Examples

Basic waveform editor

BWAVeform:COMPile

BWAVEFORM:COMPILE starts compiling the waveform as deﬁned by the Basic

Waveform editor.

BWAVeform:COMPile:CASSign

This command sets or returns the state (enabled or disabled) of the Basic Waveform editor to either compile the waveform and immediately assign it to a speciﬁed channel (enabled) or just compile the waveform (disabled).

Group

Syntax

Related Commands

Arguments

Returns

Examples

Basic waveform editor

BWAVeform:COMPile:CASSign {0|1|OFF|ON} BWAVeform:COMPile:CASSign?

BWAVeform:COMPile:CHANnel, BWAVeform:COMPile:PLAY

0 or OFF sets the Basic Waveform editor to compile only. 1 or ON sets the Basic Waveform editor to compile and assign the waveform to a channel.

A single <Boolean> value.

BWAVEFORM:COMPILE:CASSIGN 1 enables the compile and assign function.

BWAVEFORM:COMPILE:CASSIGN? might return 0, indicating that the compile

and assign function is disabled.

AWG5200 Series Programmer Manual 2-55

Command descriptions

BWAVeform:CO

Argument

Returns

Examples

MPile:CHANnel

This command sets or returns the playout channel intended for the compiled waveform of the Basic Waveform editor plug-in. The selected channel is also used to set the amp

Group

Syntax

Basic waveform e ditor

BWAVeform:COMPile:CHANnel {<channel_number>}

<channel_number>::= <NR1> value. This enables the Compile and Assign setting

and sets the speciﬁed channel assignment and uses the channel’s settings for amplitude and offset values. The chan

A single <NR1> value.

BWAVEFORM:COMPILE:CHANNEL 2 sets the Basic Waveform editor to compile

the waveform, use channel 2 to deﬁne the amplitude and offset, and assign the

eform to channel 2.

wav

litude and offset range.

nel value can not exceed the number of available channels.

BWAVEFORM:COMPILE:CHANNEL? might return NONE, indicating that the Basic

veform editor will only compile the waveform, and not assign the waveform

Wa to a channel.

2-56 AWG5200 Series Programmer Manual

Command descriptions

BWAVeform:CO

Arguments

Examples

MPile:NAME

This command sets or returns the name of the Basic Waveform editor plug-in compiled waveform.

If the name already exists in the Waveform List, the name is appended with an underscore sufﬁxsuchas“Waveform_1”.

Group

Syntax

Basic waveform editor

BWAVeform:COMPile:NAME <waveform_name> BWAVeform:COMPile:NAME?

<waveform_name>::= <string>

BWAVEFORM:COMPILE:NAME “Basic_Waveform” sets name of the compiled

waveform from the Basic Waveform editor plug-in to “Basic_Waveform”.

BWAVEFORM:COMPILE:NAME? might return “Basic_Waveform” as the name of

the compiled waveform from the Basic Waveform editor plug-in.

AWG5200 Series Programmer Manual 2-57

Command descriptions

BWAVeform:CO

Conditions

Related Commands

Arguments

Returns

MPile:PLAY

This command sets or returns the state (enabled or disabled) of the Basic Waveform editor to either immediately play the waveform after compile or just compile.

This command requires that the compiled waveform is assigned to a channel.

Group

Syntax

Basic waveform e ditor

BWAVeform:COMPile:PLAY {0|1|OFF|ON} BWAVeform:COMPile:PLAY?

BWAVeform:COMPile:CHANnel

0 or OFF disables Play After Assign. 1 or ON enables Play After Assign.

A single <Boolean> value.

Examples

BWAVEFORM:COMPILE:PLAY 1 enables the play after assign function.

BWAVEFORM:COMPILE:PLAY? might return 0, indicating that play after assign

function is disabled.

2-58 AWG5200 Series Programmer Manual

Command descriptions

BWAVeform:CY

Conditions

Related Commands

Argumen

Examples

CLe

Group

Syntax

Returns

This command sets or returns the Cycle value (number of times the waveform repeats) for the waveform created by the Basic Waveform editor plug-in.

This command has no effect if "Cycle" is set to auto-calculate.

Basic waveform editor

BWAVeform:CYCLe <cycle>

BWAVeform:AUTO

<cycle>::= <NR2> value.

A single <NR2> value.

BWAVEFORM:CYCLE 100 sets the number of Cycles to 1 00.

BWAVEFORM:CYCLE? might return 500.0000000000, indicating the Cycle value

for the compiled waveforms is set to 500.

AWG5200 Series Programmer Manual 2-59

Command descriptions

BWAVeform:FD

Conditions

Range

This command sets or returns the state (enabled or disabled) of the Basic Waveform editor plug-in to use or not use the full DAC range during compile.

Using the full DAC range when compiling waveforms results in waveforms with the best resolution.

When enabled, if the selected offset and amplitude are within the range of the instrument’s hardware, then the compiled waveform is compiled using the full DAC range a properties are set to the requested amplitude and offset values. If the selected offset and amplitude will result in a compiled waveform that does not take advantage of the full DAC range, the instrument adjusts the compiled waveform’s recommended amplitude and offset values to use the full DAC range. If the system cannot achieve the full DAC range, a warning message is displayed.

When disabled, the waveform is compiled using the speciﬁed amplitude and offset values and the compiled waveform’s recommended amplitude is set to the max available for a DC waveform.

setting is not applied for DC waveforms.

This

nd the compiled waveform’s recommended amplitude and offset

imum value and the recommended offset is set to 0. The control is not

Group

Syntax

guments

Returns

Examples

Basic waveform e ditor

BWAVeform:FDRange {0|1|OFF|ON}

0 or OFF disables Use full DAC range. 1 or ON enables Use full DAC range.

A single <Boolean> value.

BWAVEFORM:FDRANGE 1 enables the “Use full DAC range” state.

BWAVEFORM:FDRANGE? might return 0, indicating the “Use full DAC range”

state is disabled.

2-60 AWG5200 Series Programmer Manual

Command descriptions

BWAVeform:FR

Conditions

Related Commands

Argumen

Examples

EQuency

Group

Syntax

Returns

This command sets or returns the Frequency for the waveform created by the Basic Waveform editor plug-in.

This command has no effect if "Frequency" is set to auto-calculate.

Basic waveform editor

BWAVeform:FREQuency <frequency>

BWAVeform:AUTO

<frequency>::= <NRf> value.

A single <NR3> value.

BWAVEFORM:FREQUENCY 1E9 sets the Frequency to 1 GHz.

BWAVEFORM:FREQUENCY? might return 1.0000000000E+9, indicating the

Frequency for the compiled waveforms is set to 1 GHz.

AWG5200 Series Programmer Manual 2-61

Command descriptions

BWAVeform:FU

Arguments

Examples

NCtion

Group

Syntax

Returns

This command sets or returns the Basic Waveform editor plug-in waveform type.

Basic waveform e ditor

BWAVeform:FUNCtion {sine|square|triangle|ramp|noise|DC} BWAVeform:FUNCtion?

*RST sets this to SINE.

Sine Square Triangle Ramp Noise DC

BWAVEFORM:FUNCTION "sine" sets the Basic Waveform editor plug-in

waveform type to a Sinewave.

BWAVEFORM:FUNCTION? might return "Sine ", indicating that the Basic

Waveform editor plug-in waveform type is set to Sinewave.

2-62 AWG5200 Series Programmer Manual

Command descriptions

BWAVeform:HI

Conditions

Related Commands

Arguments

Group

Syntax

This command sets or returns the High voltage value for the waveform created by the Basic Waveform editor plug-in.

The High and Low values are initially one half the amplitude of the waveform (with an offset of 0 V). Changing these values causes the Amplitude value to adjust. Ch Offset value.

Basic wav

BWAVeform:HIGH <high>

BWAVeform:OFFSet, BWAVeform:HIGH, BWAVe

<high>::= <NRf> value.

anging the High and Low to uneven values cause a change to the

eform editor

form:LOW

Returns

Examples

A single <NR3> value.

AVEFORM:HIGH 200E-3

BWAVEFORM:HIGH? might return 250.0000000000E-3, indicating the High for

he compiled waveforms is set to 250 mV.

sets the High value to 200 mV.

AWG5200 Series Programmer Manual 2-63

Command descriptions

BWAVeform:LE

Conditions

Related Commands

Argumen

Examples

NGth

Group

Syntax

Returns

This c o mmand sets or returns the Length for the waveform created by the Basic Waveform editor plug-in.

This command has no effect if "Length" is set to auto-calculate.

Basic waveform e ditor

BWAVeform:LENGth <length>

BWAVeform:AUTO

<frequency>::= <NR3> value.

A single <NR3> value.

BWAVEFORM:LENGTH 1E9 sets the Length to 1 GSamples.

BWAVEFORM:LENGTH? might return 2.0000000000E+9, indicating the Length

for the compiled waveforms is set to 2 GSamples.

2-64 AWG5200 Series Programmer Manual

Command descriptions

BWAVeform:LO

Conditions

Related Commands

Arguments

Group

Syntax

This command sets or returns the Low voltage value for the waveform created by the Basic Waveform editor plug-in.

The High and Low values are initially one half the amplitude of the waveform (with an offset of 0 V). Changing these values causes the Amplitude value to adjust. Ch Offset value.

Basic wav

BWAVeform:LOW <low>

BWAVeform:OFFSet, BWAVeform:HIGH, BWAVe

<low>::= <NRf> value.

anging the High and Low to uneven values cause a change to the

eform editor

form:LOW

Returns

Examples

A single <NR3> value.

AVEFORM:LOW 200E-3

BWAVEFORM:LOW? might return 250.0000000000E-3, indicating the Low for

he compiled waveforms is set to 250 mV.

sets the Low value to 200 mV.

AWG5200 Series Programmer Manual 2-65

Command descriptions

BWAVeform:OF

Conditions

d Commands

Relate

FSet

Group

Syntax

This command sets or returns the Offset voltage value for the waveform created by the Basic Waveform editor plug-in.

This setting can be affected if the system is set to use the full DAC range. Using the full DAC range is the default setting. Refer to the command

BWAVeform:

The amplitude settings for High and Low voltage values can be affected by the Offset se

Basic waveform e ditor

BWAVeform:OFFSet <offset>

BWAVeform:OFFSet, BWAVeform:HIGH, BWAVeform:LOW, BWAV

FDRange for more information.

tting.

eform:FDRange

Arguments

Returns

Examples

<offset>::= <NRf> value.

A single <NR3> value.

WAVEFORM:OFFSET 2E-3

BWAVEFORM:OFFSET? might return 5.0000000000E-3, indicating the Offset for

the compiled waveforms is set to 5 mV.

sets the Offset to 2 mV.

2-66 AWG5200 Series Programmer Manual

Command descriptions

BWAVeform:RE

Examples

BWAVefo

rm:SRATe

Conditions

Set (No Query Form)

This command resets the Basic Waveform editor p lug-in to its default values.

Group

Syntax

Grou

Basic waveform editor

BWAVeform:RESet

BWAVEFORM:RESET sets the Basic Waveform editor plug-in parameters to their

default values.

This command sets or returns the Sample Rate for the waveform created by the Basic Waveform editor plug-in.

This command has no effect if "Sample Rate" is set to auto-calculate.

Basic waveform editor

Syntax

Related Commands

guments

Returns

Examples

BWAVeform:SRATe <sample_rate>

BWAVeform:AUTO

<sample_rate>::= <NR3> value.

Range: Min = 298 S/s, Max = 2.5 GS/s (option 25) or 5 GS/s (option 50)

Other waveform settings may restrict minimum and maximum values.

A single <NR3> value.

BWAVEFORM:SRATE 1E9 sets the Sample Rate to 1 GS/s.

BWAVEFORM:SRATE? might return 2.0000000000E+9, indicating the Sample

Rate for the compiled waveforms is set to 2 GS/s.

AWG5200 Series Programmer Manual 2-67

Command descriptions

*CAL? (Query O

Conditions

Related Commands

Returns

Examples

nly)

Group

Syntax

This query runs all selected calibrations and returns a status code indicating the success or failure of all calibrations. Any single calibration failure returns a failure code. *CAL? i

Use CALibration:RESult? to retrieve more detailed error information.

All calibrations are selected by default and cannot be modiﬁed by the user.

IEEE mandated and optional

*CAL?

CALibration[:ALL], CALibration:RESult?

A single <NR1> value, {0|-340}

*CA

might return -340 on any failure, 0 on all pass.

s equivalent to the CALibration[:ALL] command.

2-68 AWG5200 Series Programmer Manual

Command descriptions

CALibration:

Related Commands

ABORt (No Query Form)

This command stops the self calibration process and restores the previous calibration constants.

Conditions

Group

Syntax

Examples

Setting only works in the active mode for calibration. See the ACTive:MODE command.

This command does not abort the CALibration[:ALL] command.

This is an overlapping command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Calibration

CALibration:ABORt

ACTive:MODE, CALibration:STARt

CALIBRATION:ABORT *OPC?

stops the calibration process. The overlapping command is followed with an Operation Complete query.

AWG5200 Series Programmer Manual 2-69

Command descriptions

CALibration[

Related Commands

:ALL]

Conditions

Group

Syntax

Returns

This command does a full calibration of the AWG. In its query form, the command does a full calibration and returns a status indicating the success or failure of the operation. T

This command cannot be aborted.

This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Calibra

CALibration[:ALL] CALibration[:ALL]?

*CAL?

0 indicates no error –340 indicates an error

his command is equivalent to the *CAL? command.

tion

Examples

CALIBRATION:ALL performs a calibration.

CALIBRATION:ALL? performs a calibration and returns results. For example, it

might return

0, indicating that the calibration completed without any errors.

2-70 AWG5200 Series Programmer Manual

Command descriptions

CALibration:

CATalog? (Query Only)

This command returns the list of calibration procedures.

All tests are grouped by areas. All areas are grouped by subsystems. The available subsystems, areas, and tests depend on the type of testing (such as POST or ALL).

Group

Syntax

Arguments

Calibration

CALibration:CATalog? [{ALL|<subsystem>}[,{ALL|<area>}]]

ALL – Keyword or as a string. <subsystem> – a subsystem as a string. <area> – an area as a string.

If there are no parameters, then the list of subsystems is returned. If there is a valid subsystem parameter, then the list of areas for that subsystem is returned. If the subsystem parameter is "ALL", then all the procedures of all the

of all the subsystems is returned. Each procedure is preﬁxed with

areas "<subsystem>:<area>:" and separated by a comma. Lists are always in priority of desired execution. If the area parameter is "ALL", then all the procedures of all the areas for a speciﬁed subsystem is returned. Each procedure is preﬁxed with "<area>:" and separated by a comma. Lists are always in priority of desired execution.

he subsystem and area parameters are valid, then the list of procedures for that

If t subsystem and area is returned.

tring of all calibration "subsystems", "areas" and/or "procedures" separated

Returns

Examples

AWG5200 Series Programmer Manual 2-71

S by commas.

CALIBRATION:CATALOG? might return

"Initialization,Channel1,Channel2,System".

CALIBRATION:CATALOG? "Channel1" might return

"Dc,Adc,Clock,Align,Dac,Marker1,Marker2"

CALIBRATION:CATALOG? "ALL" might return

Initialization:Init:Calibration Initialization,Channel1:Dc:Differential Offset,Channel1:Dc:Common Mode,Channel1:Dc:Amplitude,Channel1:Adc:Adc Internal,Channel1:Clock:Clock Amplitude,Channel1:Clock:Clock Offset, Channel1:Align:Sample Point, Channel1:Dac:Speed"

Command descriptions

CALibration:

Related Commands

LOG? (Query Only)

This command returns a string of continuous concatenated calibration results. The start time is recorded plus one or more <cal path>:<cal name> <result>. This command

CALibration:LOG:CLEar command to start a fresh log and provide additional

information.

Log results are still valid if the calibration is aborted and the calibration constants are restored.

NOTE. The returned string is limited, which can cause lost results. Only the ﬁrst

64K of text is recorded.

Group

Syntax

Calibration

CALibration:LOG?

CALibration:LOG:CLEar

can be issued while calibration is still in progress. Use the

Retur

Exa

mples

<string>::="<Started timestamp><LF delimiter><calibration name and result>[<LF delimiter><calibration name and result>]"

CALIBRATION:LOG? might return "Channel1:Dc:Amplitude Started 6/14/2011 10:19 AM<LFCR>Channel1:Dc:Amplitude FAIL<LFCR>Channel1:Dc:Common Mode Offset Started 6/14/2011 10:23 AM<LFCR>Channel1:Dc:Common Mode Offset PASS<LFCR>"

2-72 AWG5200 Series Programmer Manual

Command descriptions

CALibration:

Related Commands

LOG:CLEar (No Query Form)

This command clears the results log.

The command works when in the active mode for calibration. See the

ACTive:MODE command.

Group

Syntax

Example

Calibration

CALibration:LOG:CLEar

ACTive:MODE

CALIBRATION:LOG:CLEAR clears the results log.

AWG5200 Series Programmer Manual 2-73

Command descriptions

CALibration:

Related Commands

LOG:FAILuresonly

This command sets or returns the ﬂag that controls the amount of result information saved into the log. This controls all tests that pass or fail or only tests that fail. It to be saved during the test execution.

Conditions

Group

Syntax

Arguments

The set for the ACTive:MODE command.

Calibrat

CALibration:LOG:FAILuresonly {OFF|ON|0|1} CALibration:LOG:FAILuresonly?

ACTive:MODE

OFF disables the failures only mode. ON enables the failures only mode. <Boolean> {0|1}. 0 and 1 are the equivalent of OFF and ON respectively.

is important to note, that details are generated during the test, and need

m of this command only works in the active mode for calibration. See

ion

Returns

Examples

*RST sets this to 0.

A single <Boolean> value representing current calibration log failures only state {0|1}.

CALIBRATION:LOG:FAILURESONLY OFF disables the failure only log mode.

CALIBRATION:LOG:FAILURESONLY 1 enables the failure only log mode.

CALIBRATION:LOG:FAILURESONLY? might return 1, indicating the failure only

log mode is enabled.

2-74 AWG5200 Series Programmer Manual

Command descriptions

CALibration:

Related Commands

RESTore(NoQueryForm)

This command restores the calibration constants from the factory non-volatile memory and copied to user storage.

Conditions

Group

Syntax

Examples

Setting only works in the active mode for calibration. See the ACTive:MODE command.

This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Calibration

CALibration:RESTore

ACTive:MODE

CALIBRATION:RESTORE sets all calibration constants to their factory settings.

AWG5200 Series Programmer Manual 2-75

Command descriptions

CALibration:

RESult? (Query Only)

This command returns the status of the last calibration procedure. This query-only command can be issued while calibration i s in progress.

Group

Syntax

Returns

Calibration

CALibration:RESult?

"<result record>" <result record>::= <subsystem>:[<area>:[<procedure>:]]<details>

<details>::= <Status>,<Loop Count>,<Pass>,<Fail> <Status>::= S(C|R|U) Reﬂexs the "current" or "last" state. Currently by request, when the status reﬂects only the subsystem or area, then a U for Unknown/Uncalibrated will be set for any of the procedures that are unknown even if it is only 1 out of 10 selected procedures. <Loop Count> ::= LC(#) <Pass> ::= P(#) <Fail> ::= F(#) C ::= Calibrated I ::= Initialized (selected) but has not run R ::= Running U ::= Unknown or Uncalibrated #::=<NR1>

Examples

Query a speciﬁc calibration result: CAL:RESult?

"Channel1""Clock","Amplitude"

"Channel1:Clock:Clock A mplitude::=S(C),LC(0),P(0),F(0);"

Query all calibration results: calibration completed and passed.

Query a speciﬁcarearesult: return "Channel1:Clock::=(C);"

Query a speciﬁ c subsystem result: "Channel1::=(R);"

Query all calibration results of a speciﬁcarea:

CAL:RESult? "Channel1","Clock",ALL

might return "Channel1:Clock:Clock Amplitude::=S(C),LC(0),P(0),F(0);Channel1:Clock:Clock Offset::=S(U),LC(0),

Asking for all calibration results of a speciﬁc subsystem:

"Channel1",ALL

P(0),F(0);"

might

CAL:RESult? "INT::=(C);" signifying internal

CAL:RESult? "Channel1" "Clock" might

return

might return might return

CAL:RESult? "Channel1" might return

CAL:RESult?

2-76 AWG5200 Series Programmer Manual

Command descriptions

"Channel1:Dc: Channel1:Align::=(U);Channel1:Dac::=(U);Channel1:Marker1::=(U); Channel1:Marker2::=(U);"

:=(U);Channel1:Adc::=(U);Channel1:Clock::=(U);

AWG5200 Series Programmer Manual 2-77

Command descriptions

CALibration:

RESult:TEMPerature? (Query Only)

This command returns the temperature of the last calibration. All temperatures are in °C.

Group

Syntax

Returns

Examples

Calibration

CALibration:RESult:TEMPerature?

<T> ::= {<NR1>} Returns the temp in °C. Uncalibrated returns an empty string.

Query a temperature result:

CAL:RE

S:TEMP?

might return "INT::=Temp(33),".

CALibration:RESult:TIME? (Query On ly)

This command returns the time of the last calibration.

Group

tax

Syn

Returns

Examples

Calibration

CALibration:RESult:TIME?

<T> ::= "mm/dd/yyyy hh:mm {A|P}M"

Query a speciﬁc time result: CAL:RES:TIM? might return

"INT::=Time(2/6/2013 8:38:34 AM),".

2-78 AWG5200 Series Programmer Manual

Command descriptions

CALibration:

RUNNing? (Query Only)

This command returns the name of the subsystem, area, and procedure in progress. This command can be issued while procedure is in progress.

Group

Syntax

Returns

Examples

Calibration

CALibration:RUNNing?

A string of colon separated "subsystem", "area:" and "procedure".

CALIBRATION:RUNNING? might return "Channel1:Dc:Amplitude",

indicating the subsystem, area, and procedure in progress. A return of there isn't a currently running procedure.

CALibration:STARt (No Query Form)

This command starts the calibration.

"" indicates

Conditions

Group

Syntax

Related Commands

Examples

Setting only works in the active mode for calibration. See the ACTive:MODE command.

This is an overlapping command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Calibration

CALibration:STARt

ACTive:MODE, CALibration:ABORt

CALIBRATION:START *OPC?

starts the execution of calibration routines. The overlapping command is followed with an Operation Complete query.

AWG5200 Series Programmer Manual 2-79

Command descriptions

CALibration:

STATe:FACTory? (Query Only)

This command returns the current factory state of the calibration for the AWG.

A calibration state will be Calibrated or Uncalibrated.

Areas will be calibrated when all procedures for that area have been executed and passed.

Subsystems will be calibrated when all areas for that subsystem are calibrated.

Each calibrated (as opposed to uncalibrated) state will have a temperature and date time.

An uncalibrated state will not have a valid temperature or date time and should be ignored.

Conditions

Group

Syntax

Results will be undetermined if there is a calibration procedure in progress.

ration

Calib

CALibration:STATe:FACTory?[<subsystem>][,<area>]]

Arguments

Returns

Examples

st> ::= <string>

<te

"<State>"

<State> ::= S(C|U) Reﬂects the "current" state. C ::= Calibrated U ::= Uncalibrated

::= Date and time

D T ::= Temperature in °C

Query the factory calibration state of the system: C ALIBRATION:STATE:

FACTORY?

Query a speciﬁcareastate:

"Channel1","Dc" 12:00:00 AM),T(0)"

might return "INT::=S(C),D(2/1/2013 12:00:00 AM),T(44)"

CALIBRATION:STATE:FACTORY?

might return "Channel1:Dc::=S(U),D(1/1/1970

2-80 AWG5200 Series Programmer Manual

Command descriptions

CALibration:

STATe:USER? (Query Only)

This command returns the current user state of the calibration for the AWG.

A calibration state will be Calibrated or Uncalibrated.

Areas will be calibrated when all procedures for that area have been executed and passed.

Subsystems will be calibrated when all areas for that subsystem are calibrated.

Each calibrated (as opposed to uncalibrated) state will have a temperature and date time.

An uncalibrated state will not have a valid temperature or date time and should be ignored.

Group

Syntax

Arguments

Calibration

CALibration:STATe:USER? [<subsystem>[,<area>]]

a> ::= <string>

<are

Returns

Examples

"<State>"

<State> ::= S(C|U) Reﬂects the "current" state. C ::= Calibrated U ::= Uncalibrated

:= Date and time

D: T ::= Temperature in °C

Asking for a speciﬁc subsystem state: CALIBRATION:STATE:USER?

"Channel1"

Query a speciﬁcareastate: might return "Channel1:Dc::=S(C),D(1/1/2013 12:00:02 AM),T(32)".

might return "Channel1::=S(C),D(1/1/2013 12:01:52 AM),T(112)"

CALIBRATION:STATE:USER? "Channel1","Dc"

AWG5200 Series Programmer Manual 2-81

Command descriptions

CALibration:

STOP:STATe? (Query Only)

This command returns the state of the calibration procedure.

Group

Syntax

Returns

Examples

Calibration

CALibration:STOP:STATe?

A single <Boolean> value, {0|1} 1 is stopped and 0 is not stopped.

CALIBRA

TION:STOP:STATE?

might return 1.

2-82 AWG5200 Series Programmer Manual

Command descriptions

CLOCk:ECLock

Conditions

Related Commands

:DIVider

Group

Syntax

This command sets or returns the divider rate for the external clock.

Setting the external clock divider rate forces the external clock multiplier rate to a value of 1.

This command is only valid if the clock source is set to External. See the

CLOCk:SOURce command.

This is an overlapping command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Clock

CLOCk:ECLock:DIVider <NR1> CLOCk:ECLock:DIVider?

CLOCk:ECLock:MULTiplier, CLOCk:SRATe, CLOCk:SOURce

Arguments

Returns

Examples

A single <NR1> value that is a power of 2.

Range: 1 to 2 (Where the maximum n value is the External Clock Rate/2n. The minimum n value is ≥ the minimum sample rate).

*RST sets this to 1.

A single <NR1> value.

CLOCK:ECLOCK:DIVIDER 4 *OPC?

sets the external clock divider rate to 4. The overlapping command is followed with an Operation Complete query.

CLOCK:ECLOCK:DIVIDER? might return 4, indicating the external clock divider

rate is set to 4.

AWG5200 Series Programmer Manual 2-83

Command descriptions

CLOCk:ECLock

Conditions

Related Commands

Arguments

:FREQuency

This command sets or returns the expected frequency being provided by the external clock.

This is an overlapping command. (See page 2-9, Sequential, blocking, and overlapping commands.)

Group

Syntax

Clock

CLOCk:ECLock:FREQuency <NR3> CLOCk:ECLock:FREQuency?

CLOCk:SOURce

A single <NR3> value.

Range: 2.5 GHz to 5 GHz

*RST setsthisto2.5GHz

Returns

Examples

A single <NR3> value.

CLOCK:ECLOCK:FREQUENCY 1E9 *OPC?

sets the expected frequency of the external clock to 1 GHz. The overlapping command is followed with an Operation Complete query.

LOCK:ECLOCK:FREQUENCY? might return 1.0000000000E+ 9, indicating that

the expected frequency of the external clock is 1 GHz.

2-84 AWG5200 Series Programmer Manual

Tektronix AWG5202, AWG5204, AWG5208 Programmer

Specifications and Main Features

Frequently Asked Questions

User Manual