AWG5200 Series Arbitrary Waveform Generators Programmer Manual 077133700
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 421
| Download | |
| Open PDF In Browser | View PDF |
xx
ZZZ
AWG5200 Series
Arbitrary Waveform Generators
Programmer
*P077133700*
077-1337-00
xx
ZZZ
AWG5200 Series
Arbitrary Waveform Generators
Programmer
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. Specifications 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. Box 500
Beaverton, OR 97077
USA
For product information, sales, service, and technical support:
In North America, call 1-800-833-9200.
Worldwide, visit www.tek.com to find contacts in your area.
Table of Contents
Preface ..............................................................................................................
iii
Getting Started
Introduction .......................................................................................................
Remote control....................................................................................................
Ethernet control .........................................................................................
GPIB control.............................................................................................
1-1
1-2
1-2
1-2
Syntax and Commands
Command syntax .................................................................................................
Syntax overview .............................................................................................
Command and query structure .............................................................................
Clearing the instrument .....................................................................................
Command entry ..............................................................................................
Parameter types ..............................................................................................
SCPI commands and queries ...............................................................................
Sequential, blocking, and overlapping commands .......................................................
Command groups ...............................................................................................
Auxiliary out commands ..................................................................................
Basic waveform editor commands .......................................................................
Calibration group commands .............................................................................
Capture and playback group commands ................................................................
Clock group commands ...................................................................................
Control group commands .................................................................................
Diagnostic group commands .............................................................................
Display group commands .................................................................................
Function generator group commands....................................................................
IEEE mandated and optional group commands ........................................................
Instrument group commands .............................................................................
Mass memory group commands .........................................................................
Output group commands ..................................................................................
S-Parameters group commands ..........................................................................
Sequence group commands...............................................................................
Source group commands ..................................................................................
Status group commands ...................................................................................
Synchronization group commands .......................................................................
System group commands .................................................................................
Trigger group commands .................................................................................
AWG5200 Series Programmer Manual
2-1
2-1
2-1
2-2
2-3
2-4
2-8
2-9
2-13
2-13
2-13
2-14
2-15
2-16
2-17
2-18
2-19
2-20
2-20
2-21
2-21
2-23
2-23
2-25
2-27
2-29
2-29
2-30
2-31
i
Table of Contents
Waveform group commands..............................................................................
Waveform plug-in group commands.....................................................................
Command descriptions.........................................................................................
2-31
2-33
2-35
Status and Events
Status and events .................................................................................................
Status and event reporting system .........................................................................
Status byte ....................................................................................................
Standard Event Status Block (SESB)......................................................................
Operation status block.......................................................................................
Questionable status block ...................................................................................
Queues ........................................................................................................
Status and event processing sequence .....................................................................
Synchronizing execution ....................................................................................
Error messages and codes .....................................................................................
Command errors ...........................................................................................
Execution errors............................................................................................
Device specific errors .....................................................................................
Query and system errors ..................................................................................
Instrument specific error codes ...........................................................................
3-1
3-1
3-3
3-4
3-5
3-6
3-7
3-8
3-9
3-11
3-11
3-12
3-14
3-15
3-15
Appendices
Appendix A: Character charts..................................................................................
Appendix B: Raw socket specification ........................................................................
Appendix C: Factory initialization settings ...................................................................
ii
A-1
B-1
C-1
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.
Documentation
Review the following table to locate more information about this product.
You can download PDF files 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 available
for download.
Operation and User
Interface Help
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 file and is
available for download.
Programmer
commands
The Programmer document provides the proper syntax of remote
commands.
Specifications
and Performance
Verification procedures
This Technical Reference document provides the specifications
and the performance verification procedures.
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 source, setting sampling rate, and exporting data for use in other programs.
In addition to the LAN electronic interface, your AWG is provided with a TekVISA
GPIB-compatible interface, (referred to as the virtual GPIB interface).
The programmer guide is divided into the following major sections:
Getting Started: provides 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
commands, such as how commands and queries are constructed, how to enter
commands, constructed mnemonics, and argument types.
Command syntax:
Command groups: contains all the commands listed in functional groups.
Each group consists of an overview of the commands in that group and a
table that lists all the commands and queries for that group.
Status and Events: discusses the status and event reporting system for the
LAN interface. This system informs you of certain significant events that
occur within the instrument.
Appendices: contains miscellaneous information, such as LAN interface
specifications that may be helpful when using remote commands.
AWG5200 Series Programmer Manual
1-1
Remote control
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 specified to automatically acquire an IP
address by DHCP. Refer to Windows documentation regarding network-related
parameters.
GPIB control
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
USB cable to the USB 2.0 high-speed (HS) device port on the rear panel of the
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:
1-2
AWG5200 Series Programmer Manual
Remote control
A unique device address must be assigned to each device on the bus. No two
devices can share the same device address.
No more than 15 devices can be connected to any one line.
One device should be connected for every 6 feet (2 meters) of cable used.
No more than 65 feet (20 meters) of cable should be used to connect devices
to a bus.
At least two-thirds of the devices on the network should be powered on while
using the network.
Connect the devices on the network in a star or linear configuration. Do not
use loop or parallel configurations.
The default setting for the GPIB configuration 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.
AWG5200 Series Programmer Manual
1-3
Remote control
1-4
AWG5200 Series Programmer Manual
Syntax and Commands
Command syntax
Syntax overview
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 commands and queries. The topics also describe the conventions that the
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 specific command.
Refer to the following table for the symbols that are used.
Table 2-1: Syntax symbols and their meanings
Symbol
<>
Meaning
::=
Is defined as
|
Exclusive OR
{}
Group; one element is required
[]
...
Optional; can be omitted
()
Comment
Defined element
Previous elements can be repeated
Command and query structure
Overview
Commands consist of set commands and query commands (usually called
commands and queries). Commands modify instrument settings or tell the
instrument to perform a specific action. Queries cause the instrument to return
data and status information.
Most commands have both a set form and a query form. The query form
of the command differs from the set form by its question mark on the end.
For example, the set command AWGControl:RSTate has a query form
AWGControl:RSTate?. Not all commands have both a set and a query form.
Some commands have only set and some have only query.
Messages
A command message is a command or query name followed by any information
the instrument needs to execute the command or query. Command messages may
contain five element types, defined in the following table.
AWG5200 Series Programmer Manual
2-1
Command syntax
Table 2-2: Message symbols and their meanings
Commands
Symbol
Meaning
This is the basic command name. If the header ends with a
question mark, the command is a query. The header may begin
with a colon (:) character. If the command is concatenated with
other commands, the beginning colon is required. Never use the
beginning colon with command headers beginning with a star (*).
This is a header subfunction. Some command headers have only
one mnemonic. If a command header has multiple mnemonics, a
colon (:) character always separates them from each other.
This is a quantity, quality, restriction, or limit associated with the
header. Some commands have no arguments while others have
multiple arguments. A separates arguments from the
header. A separates arguments from each other.
A single comma is used between arguments of multiple-argument
commands. Optionally, there may be white space characters
before and after the comma.
A white space character is used between a command header and
the related argument. Optionally, a white space may consist of
multiple white space characters.
Commands cause the instrument to perform a specific function or change one of
the settings. Commands have the structure:
[:][[]...]
A command header consists of one or more mnemonics arranged in a hierarchical
or tree structure. The first mnemonic is the base or root of the tree and each
subsequent mnemonic is a level or branch off the previous one. Commands at a
higher level in the tree may affect those at a lower level. The leading colon (:)
always returns you to the base of the command tree.
Queries
Queries cause the instrument to return status or setting information. Queries
have the structure:
[:]?
[:]?[[]...]
Clearing the instrument
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 syntax
Command entry
Rules
The following rules apply when entering commands:
You can enter commands in upper or lower case.
You can precede any command with white space characters. White space
characters include any combination of the ASCII control characters 00 through
09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal).
The instrument ignores commands consisting of any combination of white
space characters and line feeds.
Abbreviating
Concatenating
You can 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 set 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 first one. For example, the commands
TRIGger:IMPedance 50 and SOURce:RMODe TRIGgered, can be
concatenated into the following single command:
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
colon. For example, you can concatenate the commands TRIGger:SOURCE
EXTernal and TRIGger:SLOPe NEGative into a single command:
TRIGger:SOURce EXTernal; SLOPe NEGative
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
4. When you concatenate 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 query SOURce1:MARKer1:VOLTage:HIGH?;
SOURce1:MARKer1:VOLTage:LOW? will return the following:
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.
Terminating
This documentation uses (end of message) to represent a message
terminator.
Table 2-3: Message terminator and meaning
Symbol
Meaning
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 . There are
several different types of parameters, as listed in the following table. The
parameter type is listed after the parameter. Some parameter types are defined
specifically for the instrument command set and some are defined by SCPI.
Table 2-4: Parameter types, their descriptions, and examples
2-4
Parameter type
Description
Example
Arbitrary block
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...<&EOI>
Boolean
Boolean numbers or values
ON or ≠ 0
OFF or 0
Discrete
A list of specific values
MINimum, MAXimum
NaN
Not a Number
9.91 37
AWG5200 Series Programmer Manual
Command syntax
Table 2-4: Parameter types, their descriptions, and examples (cont.)
About MIN, MAX
Block
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
Flexible decimal numbers
that may be type NR1, NR2,
or NR3
See NR1, NR2, and NR3
examples in this table
String
Alphanumeric characters
(must be within quotation
marks)
"Testing 1, 2, 3"
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
A nonzero digit character in the range of 1–9
A digit character, in the range of 0–9
A character with the hexadecimal equivalent of 00 through FF (0
through 255 decimal) that represents actual data
A block of data bytes defined as:
::={#[...][...]
|#0[...]}
AWG5200 Series Programmer Manual
2-5
Command syntax
Arbitrary block
An arbitrary block argument is defined as:
#[...][...]
or
#0[...]
specifies the number of elements that follow. Taken together,
the and elements form a decimal integer that specifies how
many elements follow.
#0 means that the is an indefinite length block. The ends
the block.
NOTE. The AWGs do not support the indefinite format (a block starts with #0).
Quoted string
Some commands accept or return data in the form of a quoted string, which is
simply a group of ASCII characters enclosed by a single quote (') or double quote
("). For example: "this is a quoted string". This documentation represents these
arguments as follows:
Table 2-6: String symbol and meaning
Symbol
Meaning
Quoted string of ASCII text
A quoted string can include any character defined in the 7-bit ASCII character
set. Follow these rules when you use quoted strings:
1. Use the same type of quote character to open and close the string. For
example: "this is a valid string".
2. You can mix quotation marks within a string as long as you follow the
previous rule. For example, "this is an 'acceptable' string".
3. You can include a quote character within a string simply by repeating the
quote.
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
Here are some invalid strings:
"Invalid string argument' (quotes are not of the same type)
"test" (termination character is embedded in the string)
Units and SI prefix
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 . (SI prefixes 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 frequency.
Omit the unit when you describe commands, but include the SI unit prefix. Enter
both uppercase and lowercase characters. The following list shows examples of
units you can 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 prefixes, which must be included, are shown in the following table. You
can enter both uppercase and lowercase characters.
Table 2-7: SI prefixes and their indexes
SI prefix 1
Corresponding power
EX
1018
PE
1015
T
1012
G
109
MA
106
K
103
AWG5200 Series Programmer Manual
2-7
Command syntax
Table 2-7: SI prefixes and their indexes (cont.)
SI prefix 1
Corresponding power
M
10–3
U2
10–6
N
10–9
P
10–12
F
10–15
A
10–18
1
2
Note that the prefix m/M indicates 10–3 when the decimal numeric argument denotes voltage or time, but
indicates 106 when it denotes frequency.
Note that the prefix u/U is used instead of "μ".
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 prefixes need units.
correct: 10MHz, 10E+6Hz, 10E+6
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 defined 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 figure). The top level of the tree is the root node; it is
followed by one or more lower-level nodes.
You can create commands and queries from these subsystem 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, blocking, and overlapping commands
Programming commands (and queries) fall into three command type categories:
Sequential
Blocking
Overlapping
The type of command is important to consider when programming since they
could cause unexpected results if not handled correctly. See the following
explanations and examples.
Sequential commands
Most of the programming commands are sequential type commands. This simply
means a command will not start until the previous command has finished.
Following is an example of a series of sequential commands.
In normal operation, these commands could all be sent at once and they would be
queued up and executed sequentially.
Blocking commands
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
finished performing its task, such as 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
followed by a query, the query could time out because the previous blocking
commands have not finished.
Blocking commands are noted in their command descriptions.
AWG5200 Series Programmer Manual
2-9
Command syntax
Overlapping commands
Overlapping commands run concurrently with other commands, allowing
additional commands to start before the overlapping command has finished. 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.
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
requirement is to return a 1 when the operation 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 series instruments are limited to one outstanding overlapping
command per *OPC?. If two or more overlapping commands are sent and
followed by an *OPC?, then the first overlapped command to finish 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 overlapping commands as defined in the IEEE Std 488.2 standard.
Overlapping commands are noted in their command descriptions.
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 the command description, providing: a detailed description, syntax,
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 specified Auxiliary Output
connector.
AUXoutput[n]:SOURce:CMAPping
Sets or returns the Auxiliary Output channel mapping.
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 Calculate setting,
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 specified
channel (enabled) or just compile the waveform (disabled).
BWAVeform:COMPile:CHANnel
Sets or returns playout the channel intended for the compiled waveform of
the Basic Waveform editor plug-in. The 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 the Basic Waveform editor
to either immediately play the waveform after compile or just compile.
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 flag 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 files to compile into
RF waveform files 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
specified Signal Name in the captured signal list.
CPLayback:CAPTure:INSTrument:OSCilloscope
Connects to the specified oscilloscope, transfers the existing acquisition
from the oscilloscope to the AWG, and adds it to the specified signal.
CPLayback:CAPTure:INSTrument:RSA
Connects to the specified RSA (Realtime Spectrum Analyzer), transfers
the existing acquisition to the AWG, and adds it to the specified signal.
CPLayback:CLISt:NAME?
Returns the name of a signal from the Captured Signal List in the position
specified by the index value.
CPLayback:CLISt:SIGNal:DELete
Removes the specified 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 files.
CPLayback:CLISt:SIGNal:WAVeform:FOFFset
This command sets or returns the frequency offset of the specified
waveform segment of the specified signal in the Captured Signal List.
CPLayback:CLISt:SIGNal:WAVeform:NAME?
Returns the name of the specified waveform segment of the specified
signal in the Captured Signal List.
CPLayback:CLISt:SIGNal:WAVeform:OTIMe
Sets or returns the Off time between waveform segments of the specified
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 specified 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 specified carrier
frequency. A sequence will be generated if selected signal contains more
than one waveform or off time is specified. 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 define 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 or returns 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 operating 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 exists 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 exists 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 exists for backwards compatibility.
Use the command CLOCk:SOURce.
AWGControl:COMPile
Compiles an equation file and imports the waveforms (created by the
equation file) 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 exists for backwards compatibility.
Use the command [SOURce[n]:]RMODe.
AWGControl:RSTate?
Returns the state of the AWG.
Sets or returns the clock source.
Sets or returns the run mode 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?
Returns the most recently saved setup location.
AWGControl:SREStore
NOTE. This command exists for backwards compatibility.
Use the command MMEMory:OPEN:SETup.
Opens a setup file into the AWG’s setup memory.
NOTE. This command exists for backwards compatibility.
Use the command MMEMory:SAVE:SETup
AWGControl:SSAVe
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
Enables and disables access to diagnostics or calibration.
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
mode is "COUNt".
DIAGnostic:CONTrol:HALT
Determines or returns whether the next execution of diagnostics looping
stops on the first diagnostic failure that occurs or continues to loop on the
selected set of diagnostic functions.
DIAGnostic:CONTrol:LOOP
Determines or queries whether the next start of diagnostics runs once, runs
continuous loops, or loops for a number times for the selected set of tests.
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
selected tests and returns the results.
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 flag that controls the amount of result information saved
into the log.
DIAGnostic:LOOPs?
Returns the number of times that the selected diagnostics set was
completed during the current running or the last diagnostic running of the
set.
DIAGnostic:RESult?
Returns the status about the results of the last start of a set of selected
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 specific test.
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
specified 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]]:PATH
Sets or returns the function generator’s signal path for the specified
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
the SCPI standard and the specifications 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 identification 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 flag referred to as
the “No-Operation-Pending” flag. 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 finished.
*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 returns 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 file system on the AWG.
MMEMory:DATA
Sets or returns block data to/from file 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 file.
MMEMory:DELete
Deletes a file or directory from the AWG's hard disk.
MMEMory:IMPort
NOTE. This command exists for backwards compatibility.
Use the command MMEMory:OPEN.
Loads a file into the AWG waveform list.
MMEMory:IMPort[:PARameter]:NORMalize
NOTE. This command exists for backwards compatibility. Use
the command MMEMory:OPEN[:PARameter]:NORMalize.
Sets or returns if the imported data is normalized during select file format
import operations. The imported waveform data (for select file formats) is
normalized based on the option set in this command.
MMEMory:MDIRectory
Creates a new directory in the current path on the mass storage system.
MMEMory:MSIS
Sets or returns a mass storage device used by all MMEMory commands.
MMEMory:OPEN
Loads a file into the AWG waveform list.
MMEMory:OPEN[:PARameter]:NORMalize
Sets or returns if the imported data is normalized during select file format
import operations.
MMEMory:OPEN[:PARameter]:SIQ
Sets or returns if the IQ waveform (from supported formats) is separated
into two separate _I and _Q waveforms while importing.
MMEMory:OPEN:SASSet:SEQuence
Loads all sequences or a single desired sequence from a file into the
AWG’s sequences list.
MMEMory:OPEN:SASSet:SEQuence:MROPened?
Returns which sequence was most recently added or replaced from the
most recently opened or imported sequence file.
MMEMory:OPEN:SASSet[:WAVeform]
Loads all waveforms or a single desired waveform from a file into the
AWG’s waveforms list.
MMEMory:OPEN:SETup
Opens a setup file into the AWG’s setup memory.
MMEMory:OPEN:TXT
Loads a file into the AWG’s waveform list.
MMEMory:SAVE:SEQuence
Exports a sequence given a unique name to an eligible storage location as
the .SEQX file type.
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
location from the AWG’s waveforms with the AWG Specific MATLAB file
format (MAT 5).
MMEMory:SAVE[:WAVeform]:TIQ
Exports a waveform given a unique waveform name to an eligible storage
location from the AWG’s waveforms as the .TIQ file type.
MMEMory:SAVE[:WAVeform]:TXT
Exports a waveform given a unique waveform name to an eligible storage
location from the AWG’s waveforms as the .TXT file type.
MMEMory:SAVE[:WAVeform]:WFM
Exports a waveform given a unique waveform name to an eligible storage
location from the AWG’s waveforms as the .WFM file type.
MMEMory:SAVE[:WAVeform][:WFMX]
Exports a waveform given a unique waveform name to an eligible storage
location from the AWG’s waveforms as the .WFMX file type.
2-22
AWG5200 Series Programmer Manual
Command groups
Output group commands
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 specified channel.
OUTPut[n][:STATe]
Sets or returns the output state of the specified channel.
OUTPut[n]:SVALue[:ANALog][:STATe]
Sets or returns the output condition of a waveform of the specified channel
while the instrument is in the stopped state.
OUTPut[n]:SVALue:MARKer[m]
Sets or returns the output condition of the specified marker of the specified
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 specified channel
while the instrument is in the waiting-for-trigger state.
OUTPut[n]:WVALue:MARKer[m]
Sets or returns the output condition of the specified marker of the specified
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 the named 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 defined.
WLISt:SPARameter:CASCading:AGGRessor2[:
ENABle]
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.
WLISt:SPARameter:CASCading:AGGRessor[n]:
AMPLitude
Sets or returns the specified Aggressor's amplitude, in Cascading mode.
WLISt:SPARameter:CASCading:AGGRessor[n]:
CTALk
Sets or returns the specified Aggressor's crosstalk type, in Cascading
mode.
WLISt:SPARameter:CASCading:AGGRessor[n]:
DRATe
Sets or returns the specified Aggressor's data rate, in Cascading mode.
WLISt:SPARameter:CASCading:AGGRessor[n]:
SIGNal
Sets or returns specified 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
Sets or returns the filepath to the aggressor file for the specified Aggressor,
in Cascading mode.
WLISt:SPARameter:CASCading:AGGRessor[n]:
SIGNal:PRBS
Sets or returns the specified Aggressor's PRBS signal type, in Cascading
mode.
WLISt:SPARameter:CASCading:DEEMbed
Sets or returns whether the Cascading S-Parameters is to de-embed
(invert) the S-Parameters, in Cascading mode.
WLISt:SPARameter:CASCading:STAGe[m]:DRX[n]
Sets or returns the S-Parameter port assignment of the specified Stage
and the channel’s specified receiver port number (Rx-Port) in Cascading
mode and Differential Signalling Scheme (where applicable).
WLISt:SPARameter:CASCading:STAGe[m]:DTX[n]
Sets or returns the S-Parameter port assignment of the specified Stage and
the channel’s specified transmission port number (Tx-Port) in Cascading
mode and Differential Signalling Scheme (where applicable).
WLISt:SPARameter:CASCading:STAGe[m]:ENABle
Sets or returns the state of the specified Cascaded S-Parameter stage
(enabled or disabled).
WLISt:SPARameter:CASCading:STAGe[m]:FILE
Sets or returns the Filepath for the specified S-Parameters Cascading
Stage, in Cascading mode.
WLISt:SPARameter:CASCading:STAGe[m]:RX[n]
Sets or returns the S-Parameter port assignment of the specified Stage
and the channel’s specified receiver port number (Rx-Port) in Cascading
mode and Single-Ended Signalling Scheme (where applicable).
WLISt:SPARameter:CASCading:STAGe[m]:SSCHeme
Sets or returns the S-Parameter Signalling Scheme, in Cascading mode.
Signalling Scheme is only available when the Number of Ports is set to
4, 8, or 12.
WLISt:SPARameter:CASCading:STAGe[m]:TX[n]
Sets or returns the S-Parameter port assignment of the specified Stage and
the channel’s specified transmission port number (Tx-Port) in Cascading
mode and Single-Ended Signalling Scheme (where applicable).
WLISt:SPARameter:CASCading:STYPe
Sets or returns S-Parameter signal type (victim or aggressor), in Cascading
mode. The number of ports must be either 8 or 12.
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]
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.
WLISt:SPARameter:NCAScading:AGGRessor[n]:
AMPLitude
Sets or returns the specified Aggressor's amplitude, in Non-Cascading
mode.
WLISt:SPARameter:NCAScading:AGGRessor[n]:
CTALk
Sets or returns the specified Aggressor's crosstalk type, in Non-Cascading
mode.
WLISt:SPARameter:NCAScading:AGGRessor[n]:
DRATe
Sets or returns the specified Aggressor's data rate, in Non-Cascading
mode.
WLISt:SPARameter:NCAScading:AGGRessor[n]:
SIGNal
Sets or returns specified Aggressor's signal type, in Non-Cascading mode.
WLISt:SPARameter:NCAScading:AGGRessor[n]:
SIGNal:FILE
Sets or returns the filepath to the aggressor file for the specified 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
Sets or returns the specified Aggressor's PRBS signal type, in
Non-Cascading mode.
WLISt:SPARameter:NCAScading:DEEMbed
Sets or returns whether the Non-Cascading S-Parameters is to de-embed
(invert) the S-Parameters, in Non-Cascading mode.
WLISt:SPARameter:NCAScading:DRX[n]
Sets or returns the S-Parameter port assignment of the channel’s specified
receiver port number (Rx-Port) in Non-Cascading mode and Differential
Signalling Scheme (where applicable).
WLISt:SPARameter:NCAScading:DTX[n]
Sets or returns the S-Parameter port assignment of the channel’s
specified transmission port number (Tx-Port) in Non-Cascading mode and
Differential Signalling Scheme (where applicable).
WLISt:SPARameter:NCAScading:FILE
Sets or returns the filepath and file name of the S-Parameter file, in
Non-Cascading mode.
WLISt:SPARameter:NCAScading:LAYout
Sets or returns the 4 port S-Parameter Matrix Configuration, in
Non-Cascading mode.
WLISt:SPARameter:NCAScading:RX[n]
Sets or returns the S-Parameter port assignment of the channel’s specified
receiver port number (Rx-Port) in Non-Cascading mode and Single-Ended
Signalling Scheme (where applicable).
WLISt:SPARameter:NCAScading:SSCHeme
Sets or returns the S-Parameter Signalling Scheme, in Non-Cascading
mode. Signalling Scheme is only available when the Number of Ports
is set to 4, 8, or 12.
WLISt:SPARameter:NCAScading:STYPe
Sets or returns S-Parameter signal type (victim or aggressor), in
Non-Cascading mode. The number of ports must be either 8 or 12.
WLISt:SPARameter:NCAScading:TX[n]
Sets or returns the S-Parameter port assignment of the channel’s
specified transmission port number (Tx-Port) in Non-Cascading mode and
Single-Ended Signalling Scheme (where applicable).
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
values.
Sequence group commands
Use the sequence commands to define create and define 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 specified index
in the sequence list.
SLISt:SEQuence:AMPLitude
Sets or returns the Recommended Amplitude (peak-to-peak) of the
specified sequence.
SLISt:SEQuence:DELete
Deletes a specific 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 specified 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 specified 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 specified
sequence.
SLISt:SEQuence:STEP:ADD
Adds steps to an existing sequence.
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 will jump when it receives
Trigger A, Trigger B, or not jump at all.
SLISt:SEQuence:STEP[n]:EJUMp
Sets or returns the step that the sequence of play will jump to on a trigger
event.
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 specific 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 specified
sequence.
SLISt:SEQuence:STEP[n]:TASSet[m]:WAVeform
Assigns a waveform to the specified 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 sequence step.
SLISt:SEQuence:STEP[n]:TFLag[m]:DFLag
Sets or returns the Flag D value of the track in a sequence 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
specified sequence track for the named sequence.
SLISt:SIZE?
Returns the number of sequences in the sequence list.
2-26
AWG5200 Series Programmer Manual
Command groups
Source group commands
Use the source commands to define the waveform and marker outputs and
parameters.
Commands noted for backwards compatibility should not be used for new
programming applications.
Table 2-23: Source group commands and their descriptions
Command
Description
[SOURce:]FREQuency[:CW]|[:FIXed]
Sets or returns the clock sample rate of the AWG.
NOTE. This command exists 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
specified channel in units of dBm.
[SOURce:]RCCouple
Sets or returns the Coupled state (enabled or disabled) of the Run Mode
control. The Run controls consist of the Run Mode and Trigger Input.
[SOURce:]ROSCillator:MULTiplier
Sets or returns the multiplier of the external reference oscillator.
NOTE. This command exists for backwards compatibility.
Use the command CLOCk:EREFerence:MULTiplier.
[SOURce[n]:]CASSet:CLEar
This command removes the asset (waveform or sequence) from the
specified channel.
[SOURce[n]:]CASSet?
Returns the waveform or sequence name assigned to a channel.
[SOURce[n]:]CASSet:CLEar
Assigns a sequence to a channel.
[SOURce[n]:]CASSet:TYPE?
Returns the type of the asset (waveform or sequence) assigned to a
channel.
[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
the specified channel. Option DIGUP (Digital Up Converter) is required.
[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
the specified channel.
[SOURce[n]:]DMODe
Sets or returns DAC output mode type for the specified channel.
[SOURce:]IQIMode
Sets or returns the Baseband IQ Interpolation mode. IQ Interpolation mode
is coupled for all channels.
[SOURce[n]]:JUMP:FORCe
Forces the sequencer to jump to the specified step for the specified
channel.
[SOURce[n]]:JUMP:PATTern:FORCe
Generates an event forcing the sequencer to the step specified by pattern
in the pattern jump table.
[SOURce[n]:]MARKer[m]:DELay
Sets or returns the marker delay.
[SOURce[n]:]MARKer[m]:VOLTage[:LEVel][:
IMMediate][:AMPLitude]
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
Sets or returns the marker high level.
[SOURce[n]:]MARKer[m]:VOLTage[:LEVel][:
IMMediate]:LOW
Sets or returns the marker low level.
[SOURce[n]:]MARKer[m]:VOLTage[:LEVel][:
IMMediate]:OFFSet
Sets or returns the marker 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]:]SKEW
Sets or returns the skew (relative timing of the analog output) for the
waveform associated with the specified channel.
[SOURce[n]:]TINPut
Sets or returns the trigger input source.
[SOURce[n]:]VOLTage[:LEVel][:IMMediate][:
AMPLitude]
Sets or returns the amplitude for the waveform associated with a channel
in units of volts.
[SOURce[n]:]VOLTage[:LEVel][:IMMediate]:BIAS
Sets or returns the Bias (for AC output paths) for the waveform associated
with the specified channel.
[SOURce[n]:]VOLTage[:LEVel][:IMMediate]:BIAS:
ENABle
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.
[SOURce[n]:]VOLTage[:LEVel][:IMMediate]:HIGH
Sets or returns the high voltage level for the waveform associated with
the specified channel.
The value is affected by the Offset setting (for DC modes) or the Bias
setting (for AC modes).
[SOURce[n]:]VOLTage[:LEVel][:IMMediate]:LOW
Sets or returns the low voltage level for the waveform associated with a
channel.
The value is affected by the Offset setting (for DC modes) or the Bias
setting (for AC modes).
[SOURce[n]:]VOLTage[:LEVel][:IMMediate]:OFFSet
Sets or returns the Offset (for DC output paths) for the waveform associated
with the specified channel.
[SOURce[n]:]WAVeform
Sets or returns the name of the waveform assigned to a 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 commands
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/queues 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 filter value of the Operation
Transition Register (OTR).
STATus:OPERation:PTRansition
Sets or returns the positive transition filter value of the Operation Transition
Register (OTR).
STATus:PRESet
Sets the OENR and QENR 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
clears it.
STATus:QUEStionable:NTRansition
Sets or returns the negative transition filter value of the Questionable
Transition Register (QTR).
STATus:QUEStionable:PTRansition
Sets or returns the positive transition filter value of the Questionable
Transition Register (QTR).
Synchronization 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 or 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 commands
Use the system commands to control miscellaneous instrument functions and
obtain instrument information.
Table 2-26: System group commands and their descriptions
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
them from the queue.
SYSTem:ERRor:CODE:ALL?
Returns the error and event queue for the codes of all the unread items
and removes them from the queue.
SYSTem:ERRor:CODE[:NEXT]?
Returns the error and event queue for the next item and removes it from
the queue.
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.
2-30
AWG5200 Series Programmer Manual
Command groups
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
Description
ABORt
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.
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 used.
TRIGger:SLOPe
Sets or returns the external trigger slopes.
TRIGger:SOURce
Sets or returns the trigger source.
NOTE. This command exists 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 exists for backwards compatibility.
Use the commands OUTPut[n]:WVALue[:ANALog][:STATe]
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 coefficients from an external
(precompensation) file to the specified waveform (or waveforms).
WLISt:WAVeform:ACFile:GAUSsian
Sets or returns whether a gaussian filter will be applied during the
application of a precompensation file (correction coefficients file).
WLISt:WAVeform:ACFile:GAUSsian:BANDwidth
Sets or returns the bandwidth of the gaussian filter that is to be applied
during application of a precompensation file (correction coefficients file).
WLISt:WAVeform:ACFile:RSINc
Sets or returns whether or not corrections for Sin(x)/x distortions will be
removed during application of a correction file.
WLISt:WAVeform:ACFile:SKEW
Sets or returns whether the measured Skew will be applied during
application of a precompensation file (correction coefficients file).
WLISt:WAVeform:AMPLitude
Sets or returns the Recommended Amplitude (peak-to-peak) of the
specified waveform.
WLISt:WAVeform:DATA
Transfers analog waveform data from the external controller into the
specified waveform or from a waveform to the external control program.
WLISt:WAVeform:DATA:I
Transfers I waveform data from the external controller into the specified
waveform or from a waveform to the external control program.
WLISt:WAVeform:DATA:Q
Transfers Q waveform data from the external controller into the specified
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:NORMalize
Normalizes a waveform that exists in the waveform list.
WLISt:WAVeform:OFFSet
Sets or returns the Recommended Offset of the specified waveform.
WLISt:WAVeform:RESample
Resamples a waveform that exists in the waveform list.
WLISt:WAVeform:REVerse
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
specified waveform.
WLISt:WAVeform:SHIFt
Shifts the phase of a waveform that exists in the waveform list.
2-32
AWG5200 Series Programmer Manual
Command groups
Table 2-28: Waveform group commands and their descriptions (cont.)
Command
Description
WLISt:WAVeform:SRATe
Sets or returns the Recommended Sampling Rate of the specified
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 fit 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
Byte offset 3
Byte offset 2
Byte offset 1
Byte offset 0
IEEE754 single precision format (32 bits)
DAC resolution affects the way hardware interprets the bits in the waveform.
Therefore it is necessary to reload waveforms once the DAC resolution
is modified. 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 first 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 creation 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 specific 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
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Trigger
Syntax
ABORt [{ATRigger|BTRigger}]
Related Commands
Arguments
[SOURce[n]:]RMODe
ATRigger: Aborts waveform playout for all channels with the Run Mode set to
Gated and Trigger set to A.
BTRigger: Aborts waveform playout for all channels with the Run Mode set
to Gated and Trigger set to B.
Defaults to trigger A if not specified.
Examples
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-calibration commands are ignored and no action occurs.
If a test or procedure is in progress, errors are not returned; they are added to
the system error queue, which can be accessed with SYSTem:ERRor[:NEXT]?.
For example:
-200, "[D|C] are still running;"
-300,"Device-specific error; Diagnostics tests still in progress - act:mode diag"
-300,"Device-specific 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
restored.
If any diagnostic tests are in progress, then the request to change the active mode
fails and the mode will not change.
When changing the active mode, it’s recommended to follow the action with an
operation complete command (*OPC) to ensure the command has finished before
other commands are processed.
Conditions
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Diagnostic
Syntax
ACTive:MODE {NORMal|CALibration|DIAGnostic}
ACTive:MODE?
Related Commands
Arguments
DIAGnostic:ABORt, DIAGnostic:STOP, CALibration:ABORt
NORMal disables any active state for either calibration or diagnostics. When
entering the active state of normal, the hardware is set to a default state and the
previous system state is restored and waveform playout is set to off.
CALibration enables the active state for the calibration. Entering the active state
of calibration turns waveform playout off.
2-36
AWG5200 Series Programmer Manual
Command descriptions
DIAGnostic enables the active state for the diagnostics. Entering the active state
of diagnostics turns waveform playout off.
*RST sets this to NORM.
Returns
Examples
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]:SOURce
This command sets or returns the signal source for the specified Auxiliary Output
connector.
Group
Auxiliary output
Syntax
AUXoutput[n]:SOURce {AFLag|BFLag|CFLag|DFLag}
AUXoutput[n]:SOURce?
Related Commands
Arguments
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 flag)
BFL (B sequencer flag)
CFL (C sequencer flag)
DFL (D sequencer flag)
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]:SOURce:CMAPping
This command sets or returns the Auxiliary Output channel mapping.
Group
Auxiliary output
Syntax
AUXoutput[n]:SOURce:CMAPping
AUXoutput[n]:SOURce:CMAPping?
Related Commands
Arguments
AUXoutput[n]:SOURce
::={1|2} for AWG5202
::={1|2|3|4} for AWG5204
::={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 value.
AUXOUTPUT1:SOURCE:CMAPPING 2 maps channel 2 to the Auxiliary 1 output
connector.
AUXOUTPUT1:SOURCE:CMAPPING? might return 1, indicating that channel 1 is
mapped to the Auxiliary 1 output connector.
AWG5200 Series Programmer Manual
2-39
Command descriptions
AWGControl:ARSettings
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 channel.
When enabled, the system attempts to use the waveform’s recommended settings
(sample rate, amplitude, and offset) when the waveform is assigned to a channel.
This includes waveforms within sequence tracks assigned to a channel.
Recommended settings are defined as part the waveform properties and sequence
properties.
Conditions
If the waveform is of an IQ type, the recommended frequency is also used.
If a recommended value is not included with the waveform, the current system
values remains unchanged.
Group
Control
Syntax
AWGControl:ARSettings {0|1|ON|OFF}
Arguments
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.
Returns
Examples
A single 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[: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.
Conditions
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
Control
Syntax
AWGControl[:CLOCk]:DRATe
AWGControl[:CLOCk]:DRATe?
Related Commands
Arguments
CLOCk:ECLock:MULTiplier,
CLOCk:SRATe,
AWGControl[:CLOCk]:SOURce
A single value that is a power of 2.
Range: 1 to 2n
(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.
Returns
Examples
A single 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:CLOCk: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.
Conditions
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Control
Syntax
AWGControl:CLOCk:PHASe[:ADJust]
AWGControl:CLOCk:PHASe[:ADJust]?
Arguments
A single value.
Range: –8640 degrees to +8640 degrees.
Returns
Examples
A single 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[:CLOCk]:SOURce
NOTE. This command exists for backwards compatibility. Use the command
CLOCk:SOURce.
This command sets or returns the source of the clock.
Conditions
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
Group
Control
Syntax
AWGControl[:CLOCk]:SOURce
{INTernal|EXTernal|EFIXed|EVARiable}
AWGControl[:CLOCk]:SOURce?
Related Commands
Arguments
CLOCk:SOURce
INTernal – clock signal is generated internally and the reference frequency is
derived by the internal oscillator.
EFIXed – clock is generated internally and the reference frequency is derived
from a fixed 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 derived from the internal precision oscillator.
*RST sets this to INT.
Returns
Examples
INT
EXT
EFIXed
EVAR
AWGCONTROL:CLOCK:SOURCE INTERNAL
*OPC? sets the clock source to internal. The overlapping command is followed
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:COMPile (No Query Form)
This command compiles an equation file and imports the waveforms (created by
the equation file) into the arbitrary waveform generator.
Conditions
Only excepts equation files, with the ".equ" suffix.
Group
Control
Syntax
AWGControl:COMPile
Arguments
::=
File names may include full and relative paths. If a path is not specified, then the
path of "C:\ProgramData\Tektronix\AWG\model\EquationEditor" is assumed.
"model" is the model is the instrument family type.
Examples
AWGCONTROL:COMPILE “SIN.EQU” compiles the equation file 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
Control
Syntax
AWGControl:CONFigure:CNUMber?
Returns
Examples
2-44
A single value.
AWGCONTROL:CONFIGURE:CNUMBER? might return 2.
AWG5200 Series Programmer Manual
Command descriptions
AWGControl:PJUMp: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
requires a strobe signal and a pattern address change to initiate a jump. With this
setting enabled, the pattern jump disregards the pattern address change condition,
causing the jump to always occur on the strobe signal.
Group
Control
Syntax
AWGControl:PJUMp:JSTRobe {0|1|OFF|ON}
AWGControl:PJUMp:JSTRobe?
Arguments
Returns
Examples
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.
AWGCONTROL:PJUMP:JSTROBE? might return 0, indicating that pattern jump is
enabled.
AWG5200 Series Programmer Manual
2-45
Command descriptions
AWGControl:PJUMp:SEDGe
This command sets or returns the active Strobe Edge to use for Pattern Jump when
Pattern Jump is enabled for Sequencing.
Group
Control
Syntax
AWGControl:PJUMp:SEDGe {FALLing|RISing}
AWGControl:PJUMp:SEDGe?
Arguments
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.
Returns
Examples
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:RMODe
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.
Group
Control
Syntax
AWGControl:RMODe {CONTinuous|TRIGgered|GATed}
AWGControl:RMODe?
Related Commands
Arguments
[SOURce[n]:]RMODe
CONTinuous sets the Run Mode to Continuous (not waiting for a trigger event).
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.
*RST sets this to CONT.
Returns
Examples
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:RSTate? (Query Only)
This command returns the run state of the AWG.
Group
Control
Syntax
AWGControl:RSTate?
Related Commands
Returns
[SOURce[n]:]RMODe
A single value.
0 indicates that the AWG has stopped.
1 indicates that the AWG is waiting for trigger.
2 indicates that the AWG is running.
Examples
AWGCONTROL:RSTATE? might return 0, indicating that waveform generation is
stopped.
AWGControl:RUN[:IMMediate] (No Query Form)
This command initiates the output of a waveform or sequence. This is equivalent
to pushing the play button on the front-panel or display. The AWG can be put
in the run state only when waveforms or sequences are assigned to channels.
Conditions
Group
Control
Syntax
AWGControl:RUN[:IMMediate]
Related Commands
Examples
2-48
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
AWGControl:STOP[:IMMediate]
AWGCONTROL:RUN:IMMEDIATE
puts the AWG in the run state.
AWG5200 Series Programmer Manual
Command descriptions
AWGControl:SNAMe? (Query Only)
This command returns the AWG's most recently saved setup location.
The response contains the full path for the file, including the disk drive letter
(msus or, mass storage unit specifier).
Group
Control
Syntax
AWGControl:SNAMe?
Returns
Returns ,
::=
a (mass storage unit specifier) ::=
By default (when there has been no save setup command), this value is "","C:"
Examples
AWGCONTROL:SNAME? might return the following response:
"\my\project\setups\mySetup.awgx","D:"
AWG5200 Series Programmer Manual
2-49
Command descriptions
AWGControl:SREStore (No Query Form)
NOTE. This command exists for backwards compatibility. Use the command
MMEMory:OPEN:SETup.
This command opens a setup file into the AWG’s setup memory.
Conditions
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Control
Syntax
AWGControl:SREStore [,]
Related Commands
Arguments
Examples
MMEMory:OPEN:SETup
::=
(mass storage unit specifier) ::=
With mass storage unit specifier specified as a parameter:
AWGCONTROL:SRESTORE "\TestFiles\mySetup.awgx","C:"
With mass storage unit specifier specified within the file path:
AWGCONTROL:SRESTORE "C:\TestFiles\mySetup.awgx"
2-50
AWG5200 Series Programmer Manual
Command descriptions
AWGControl:SSAVe (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.
Conditions
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Control
Syntax
AWGControl:SSAVe [,]
Related Commands
Arguments
Examples
MMEMory:SAVE:SETup
::=
(mass storage unit specifier)::=
AWGCONTROL:SSAVE "C:\TestFiles\mySetup.awgx"
AWGCONTROL:SSAVE "\TestFiles\mySetup.awgx","C:"
AWG5200 Series Programmer Manual
2-51
Command descriptions
AWGControl:STOP[:IMMediate] (No Query Form)
This command stops the output of a waveform or a sequence.
Conditions
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Control
Syntax
AWGControl:STOP[:IMMediate]
Related Commands
Examples
AWGControl:RUN[:IMMediate]
AWGCONTROL:STOP:IMMEDIATE
*OPC?
stops the output of a waveform or sequence.
2-52
AWG5200 Series Programmer Manual
Command descriptions
BWAVeform:AMPLitude
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:FDRange for more information.
Conditions
The amplitude settings for Offset, High, and Low voltage values can be affected
by the Amplitude setting.
Group
Basic waveform editor
Syntax
BWAVeform:AMPLitude
Related Commands
Arguments
Returns
Examples
BWAVeform:OFFSet,
BWAVeform:HIGH,
BWAVeform:LOW
BWAVeform:FDRange
::= value.
A single value.
BWAVEFORM:AMPLITUDE 200E-3 sets the Amplitude to 200 mVpp.
BWAVEFORM:AMPLITUDE? might return 500.0000000000E-3, indicating the
Amplitude for the compiled waveforms is set to 500 mVpp.
AWG5200 Series Programmer Manual
2-53
Command descriptions
BWAVeform:AUTO
This command sets or returns the Basic Waveform editor plug-in Auto Calculate
setting, determining which value is automatically calculated.
Conditions
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.
Group
Basic waveform editor
Syntax
BWAVeform:AUTO {LEN|CYCLE|DUR|FREQ|SR}
BWAVeform:AUTO?
Related Commands
Arguments
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
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.
2-54
AWG5200 Series Programmer Manual
Command descriptions
BWAVeform:COMPile (No Query Form)
This command initiates the Basic Waveform editor plug-in compile process. The
created waveform is placed in the Waveform List.
Group
Basic waveform editor
Syntax
BWAVeform:COMPile
Examples
BWAVEFORM:COMPILE starts compiling the waveform as defined 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
specified channel (enabled) or just compile the waveform (disabled).
Group
Basic waveform editor
Syntax
BWAVeform:COMPile:CASSign {0|1|OFF|ON}
BWAVeform:COMPile:CASSign?
Related Commands
Arguments
Returns
Examples
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 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:COMPile: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 amplitude and offset range.
Group
Basic waveform editor
Syntax
BWAVeform:COMPile:CHANnel {}
Arguments
Returns
Examples
::= value. This enables the Compile and Assign setting
and sets the specified channel assignment and uses the channel’s settings for
amplitude and offset values.
The channel value can not exceed the number of available channels.
A single value.
BWAVEFORM:COMPILE:CHANNEL 2 sets the Basic Waveform editor to compile
the waveform, use channel 2 to define the amplitude and offset, and assign the
waveform to channel 2.
BWAVEFORM:COMPILE:CHANNEL? might return NONE, indicating that the Basic
Waveform editor will only compile the waveform, and not assign the waveform
to a channel.
2-56
AWG5200 Series Programmer Manual
Command descriptions
BWAVeform:COMPile: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 suffix such as “Waveform_1”.
Group
Basic waveform editor
Syntax
BWAVeform:COMPile:NAME
BWAVeform:COMPile:NAME?
Arguments
Examples
::=
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:COMPile: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.
Conditions
This command requires that the compiled waveform is assigned to a channel.
Group
Basic waveform editor
Syntax
BWAVeform:COMPile:PLAY {0|1|OFF|ON}
BWAVeform:COMPile:PLAY?
Related Commands
Arguments
Returns
Examples
BWAVeform:COMPile:CHANnel
0 or OFF disables Play After Assign.
1 or ON enables Play After Assign.
A single value.
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:CYCLe
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.
Conditions
This command has no effect if "Cycle" is set to auto-calculate.
Group
Basic waveform editor
Syntax
BWAVeform:CYCLe
Related Commands
Arguments
Returns
Examples
BWAVeform:AUTO
::= value.
A single value.
BWAVEFORM:CYCLE 100 sets the number of Cycles to 100.
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:FDRange
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 and the compiled waveform’s recommended amplitude and offset
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 specified amplitude and
offset values and the compiled waveform’s recommended amplitude is set to
the maximum value and the recommended offset is set to 0. The control is not
available for a DC waveform.
Conditions
This setting is not applied for DC waveforms.
Group
Basic waveform editor
Syntax
BWAVeform:FDRange {0|1|OFF|ON}
Arguments
Returns
Examples
0 or OFF disables Use full DAC range.
1 or ON enables Use full DAC range.
A single 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:FREQuency
This command sets or returns the Frequency for the waveform created by the
Basic Waveform editor plug-in.
Conditions
This command has no effect if "Frequency" is set to auto-calculate.
Group
Basic waveform editor
Syntax
BWAVeform:FREQuency
Related Commands
Arguments
Returns
Examples
BWAVeform:AUTO
::= value.
A single 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:FUNCtion
This command sets or returns the Basic Waveform editor plug-in waveform type.
Group
Basic waveform editor
Syntax
BWAVeform:FUNCtion {sine|square|triangle|ramp|noise|DC}
BWAVeform:FUNCtion?
Arguments
Returns
Examples
*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:HIGH
This command sets or returns the High voltage value for the waveform created
by the Basic Waveform editor plug-in.
Conditions
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. Changing the High and Low to uneven values cause a change to the
Offset value.
Group
Basic waveform editor
Syntax
BWAVeform:HIGH
Related Commands
Arguments
Returns
Examples
BWAVeform:OFFSet,
BWAVeform:HIGH,
BWAVeform:LOW
::= value.
A single value.
BWAVEFORM:HIGH 200E-3 sets the High value to 200 mV.
BWAVEFORM:HIGH? might return 250.0000000000E-3, indicating the High for
the compiled waveforms is set to 250 mV.
AWG5200 Series Programmer Manual
2-63
Command descriptions
BWAVeform:LENGth
This command sets or returns the Length for the waveform created by the Basic
Waveform editor plug-in.
Conditions
This command has no effect if "Length" is set to auto-calculate.
Group
Basic waveform editor
Syntax
BWAVeform:LENGth
Related Commands
Arguments
Returns
Examples
BWAVeform:AUTO
::= value.
A single 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:LOW
This command sets or returns the Low voltage value for the waveform created
by the Basic Waveform editor plug-in.
Conditions
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. Changing the High and Low to uneven values cause a change to the
Offset value.
Group
Basic waveform editor
Syntax
BWAVeform:LOW
Related Commands
BWAVeform:OFFSet,
BWAVeform:HIGH,
BWAVeform:LOW
Arguments
::= value.
Returns
A single value.
Examples
BWAVEFORM:LOW 200E-3 sets the Low value to 200 mV.
BWAVEFORM:LOW? might return 250.0000000000E-3, indicating the Low for
the compiled waveforms is set to 250 mV.
AWG5200 Series Programmer Manual
2-65
Command descriptions
BWAVeform:OFFSet
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:FDRange for more information.
Conditions
The amplitude settings for High and Low voltage values can be affected by the
Offset setting.
Group
Basic waveform editor
Syntax
BWAVeform:OFFSet
Related Commands
Arguments
Returns
Examples
BWAVeform:OFFSet,
BWAVeform:HIGH,
BWAVeform:LOW,
BWAVeform:FDRange
::= value.
A single value.
BWAVEFORM:OFFSET 2E-3 sets the Offset to 2 mV.
BWAVEFORM:OFFSET? might return 5.0000000000E-3, indicating the Offset for
the compiled waveforms is set to 5 mV.
2-66
AWG5200 Series Programmer Manual
Command descriptions
BWAVeform:RESet (No Query Form)
This command resets the Basic Waveform editor plug-in to its default values.
Group
Basic waveform editor
Syntax
BWAVeform:RESet
Examples
BWAVEFORM:RESET sets the Basic Waveform editor plug-in parameters to their
default values.
BWAVeform:SRATe
This command sets or returns the Sample Rate for the waveform created by the
Basic Waveform editor plug-in.
Conditions
This command has no effect if "Sample Rate" is set to auto-calculate.
Group
Basic waveform editor
Syntax
BWAVeform:SRATe
Related Commands
Arguments
BWAVeform:AUTO
::= 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.
Returns
Examples
A single 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 Only)
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? is equivalent to the CALibration[:ALL] command.
Use CALibration:RESult? to retrieve more detailed error information.
Conditions
Group
IEEE mandated and optional
Syntax
*CAL?
Related Commands
Returns
Examples
2-68
All calibrations are selected by default and cannot be modified by the user.
CALibration[:ALL],
CALibration:RESult?
A single value, {0|-340}
*CAL? might return -340 on any failure, 0 on all pass.
AWG5200 Series Programmer Manual
Command descriptions
CALibration:ABORt (No Query Form)
This command stops the self calibration process and restores the previous
calibration constants.
Conditions
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.)
Group
Calibration
Syntax
CALibration:ABORt
Related Commands
Examples
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[:ALL]
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. This command is equivalent to the *CAL? command.
Conditions
This command cannot be aborted.
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Calibration
Syntax
CALibration[:ALL]
CALibration[:ALL]?
Related Commands
Returns
*CAL?
::=
0 indicates no error
–340 indicates an error
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
Calibration
Syntax
CALibration:CATalog?
Arguments
[{ALL|}[,{ALL|}]]
ALL – Keyword or as a string.
– a subsystem as a string.
– 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
areas of all the subsystems is returned. Each procedure is prefixed with
"::" 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
specified subsystem is returned. Each procedure is prefixed with ":" and
separated by a comma. Lists are always in priority of desired execution.
If the subsystem and area parameters are valid, then the list of procedures for that
subsystem and area is returned.
Returns
Examples
String of all calibration "subsystems", "areas" and/or "procedures" separated
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"
AWG5200 Series Programmer Manual
2-71
Command descriptions
CALibration:LOG? (Query Only)
This command returns a string of continuous concatenated calibration results.
The start time is recorded plus one or more : .
This command can be issued while calibration is still in progress. Use the
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 first
64K of text is recorded.
Group
Calibration
Syntax
CALibration:LOG?
Related Commands
Returns
Examples
2-72
CALibration:LOG:CLEar
::="[]"
CALIBRATION:LOG? might return "Channel1:Dc:Amplitude
Started 6/14/2011 10:19 AMChannel1:Dc:Amplitude
FAILChannel1:Dc:Common Mode Offset Started 6/14/2011
10:23 AMChannel1:Dc:Common Mode Offset PASS"
AWG5200 Series Programmer Manual
Command descriptions
CALibration: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
Calibration
Syntax
CALibration:LOG:CLEar
Related Commands
Examples
ACTive:MODE
CALIBRATION:LOG:CLEAR clears the results log.
AWG5200 Series Programmer Manual
2-73
Command descriptions
CALibration:LOG:FAILuresonly
This command sets or returns the flag 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 is important to note, that details are generated during the test, and need
to be saved during the test execution.
Conditions
The set form of this command only works in the active mode for calibration. See
the ACTive:MODE command.
Group
Calibration
Syntax
CALibration:LOG:FAILuresonly {OFF|ON|0|1}
CALibration:LOG:FAILuresonly?
Related Commands
Arguments
ACTive:MODE
OFF disables the failures only mode.
ON enables the failures only mode.
{0|1}. 0 and 1 are the equivalent of OFF and ON respectively.
*RST sets this to 0.
Returns
Examples
A single 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:RESTore (No Query Form)
This command restores the calibration constants from the factory non-volatile
memory and copied to user storage.
Conditions
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.)
Group
Calibration
Syntax
CALibration:RESTore
Related Commands
Examples
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 is in progress.
Group
Calibration
Syntax
CALibration:RESult?
Returns
""
::= :[:[:]]
::= ,,,
::= S(C|R|U) Reflexs the "current" or "last" state. Currently by
request, when the status reflects 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.
::= LC(#)
::= P(#)
::= F(#)
C ::= Calibrated
I ::= Initialized (selected) but has not run
R ::= Running
U ::= Unknown or Uncalibrated
# ::=
Examples
Query a specific calibration result: CAL:RESult?
"Channel1""Clock","Amplitude" might return might return
"Channel1:Clock:Clock Amplitude::=S(C),LC(0),P(0),F(0);"
Query all calibration results: CAL:RESult? "INT::=(C);" signifying internal
calibration completed and passed.
Query a specific area result: CAL:RESult? "Channel1" "Clock" might
return "Channel1:Clock::=(C);"
Query a specific subsystem result: CAL:RESult? "Channel1" might return
"Channel1::=(R);"
Query all calibration results of a specific area:
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),P(0),F(0);"
Asking for all calibration results of a specific subsystem: CAL:RESult?
"Channel1",ALL might return
2-76
AWG5200 Series Programmer Manual
Command descriptions
"Channel1:Dc::=(U);Channel1:Adc::=(U);Channel1:Clock::=(U);
Channel1:Align::=(U);Channel1:Dac::=(U);Channel1:Marker1::=(U);
Channel1:Marker2::=(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
Calibration
Syntax
CALibration:RESult:TEMPerature?
Returns
Examples
::= {} Returns the temp in °C. Uncalibrated returns an empty string.
Query a temperature result:
CAL:RES:TEMP? might return "INT::=Temp(33),".
CALibration:RESult:TIME? (Query Only)
This command returns the time of the last calibration.
Group
Calibration
Syntax
CALibration:RESult:TIME?
Returns
Examples
2-78
::= "mm/dd/yyyy hh:mm {A|P}M"
Query a specific time result: CAL:RES:TIM? might return
"INT::=Time(2/6/2013 8:38:34 AM),".
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
Calibration
Syntax
CALibration:RUNNing?
Returns
Examples
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 "" indicates
there isn't a currently running procedure.
CALibration:STARt (No Query Form)
This command starts the calibration.
Conditions
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.)
Group
Calibration
Syntax
CALibration:STARt
Related Commands
Examples
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
Results will be undetermined if there is a calibration procedure in progress.
Group
Calibration
Syntax
CALibration:STATe:FACTory?[][,]]
Arguments
Returns
:::=
::=
::=
""
::= S(C|U) Reflects the "current" state.
C ::= Calibrated
U ::= Uncalibrated
D ::= Date and time
T ::= Temperature in °C
Examples
Query the factory calibration state of the system: CALIBRATION:STATE:
FACTORY? might return "INT::=S(C),D(2/1/2013 12:00:00 AM),T(44)"
Query a specific area state: CALIBRATION:STATE:FACTORY?
"Channel1","Dc" might return "Channel1:Dc::=S(U),D(1/1/1970
12:00:00 AM),T(0)".
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
Calibration
Syntax
CALibration:STATe:USER? [[,]]
Arguments
Returns
::=
::=
""
::= S(C|U) Reflects the "current" state.
C ::= Calibrated
U ::= Uncalibrated
D ::= Date and time
T ::= Temperature in °C
Examples
Asking for a specific subsystem state: CALIBRATION:STATE:USER?
"Channel1" might return "Channel1::=S(C),D(1/1/2013 12:01:52 AM),T(112)"
Query a specific area state: CALIBRATION:STATE:USER? "Channel1","Dc"
might return "Channel1:Dc::=S(C),D(1/1/2013 12:00:02 AM),T(32)".
AWG5200 Series Programmer Manual
2-81
Command descriptions
CALibration:STOP:STATe? (Query Only)
This command returns the state of the calibration procedure.
Group
Calibration
Syntax
CALibration:STOP:STATe?
Returns
Examples
2-82
A single value, {0|1} 1 is stopped and 0 is not stopped.
CALIBRATION:STOP:STATE? might return 1.
AWG5200 Series Programmer Manual
Command descriptions
CLOCk:ECLock:DIVider
This command sets or returns the divider rate for the external clock.
Conditions
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.)
Group
Clock
Syntax
CLOCk:ECLock:DIVider
CLOCk:ECLock:DIVider?
Related Commands
Arguments
CLOCk:ECLock:MULTiplier,
CLOCk:SRATe,
CLOCk:SOURce
A single value that is a power of 2.
Range: 1 to 2n
(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.
Returns
Examples
A single 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:FREQuency
This command sets or returns the expected frequency being provided by the
external clock.
Conditions
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
Group
Clock
Syntax
CLOCk:ECLock:FREQuency
CLOCk:ECLock:FREQuency?
Related Commands
Arguments
CLOCk:SOURce
A single value.
Range: 2.5 GHz to 5 GHz
*RST sets this to 2.5 GHz
Returns
Examples
A single 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
Command descriptions
CLOCk:ECLock:FREQuency:DETect (No Query Form)
This command detects the frequency of the signal applied to the Clock In
connector and adjusts the system to use the signal. The frequency is detected
once each time the command executes.
An error message is generated if no frequency is detected or is out of range.
Conditions
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.)
Group
Clock
Syntax
CLOCk:ECLock:FREQuency:DETect
Related Commands
Examples
CLOCk:SOURce
CLOCK:ECLOCK:FREQUENCY:DETECT
*OPC?
detects the clock frequency applied to the Clock In connector. The overlapping
command is followed with an Operation Complete query.
AWG5200 Series Programmer Manual
2-85
Command descriptions
CLOCk:ECLock:MULTiplier
This command sets or returns the multiplier rate of the external clock.
Conditions
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.)
Group
Clock
Syntax
CLOCk:ECLock:MULTiplier
CLOCk:ECLock:MULTiplier?
Related Commands
Arguments
CLOCk:ECLock:DIVider,
CLOCk:SRATe,
CLOCk:SOURce
::= 1
*RST sets this to 1.
Returns
Examples
A single value
CLOCK:ECLOCK:MULTIPLIER 1
*OPC?
sets the external clock multiplier to 1. The overlapping command is followed with
an Operation Complete query.
CLOCK:ECLOCK:MULTIPLIER? might return 1.0000000000, indicating the
clock multiplier is set to 1.
2-86
AWG5200 Series Programmer Manual
Command descriptions
CLOCk:EREFerence:DIVider
This command sets or returns the divider rate of the external reference signal
when the external reference is variable.
Conditions
Setting the external reference divider rate forces the external reference multiplier
rate to a value of 1.
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
Group
Clock
Syntax
CLOCk:EREFerence:DIVider
CLOCk:EREFerence:DIVider?
Arguments
A single value that is a power of 2.
Range: (External Reference Frequency/2n) > minimum sample rate.
*RST sets this to 1.
Returns
Examples
A single value.
CLOCK:EREFERENCE:DIVIDER 1
*OPC?
sets the external reference divider to 1. The overlapping command is followed
with an Operation Complete query.
CLOCK:EREFERENCE:DIVIDER? might return 1, indicating the divider rate is
set to 1.
AWG5200 Series Programmer Manual
2-87
Command descriptions
CLOCk:EREFerence:FREQuency
This command sets or returns the expected frequency of the signal applied to the
Reference In connector.
Conditions
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
Group
Clock
Syntax
CLOCk:EREFerence:FREQuency
CLOCk:EREFerence:FREQuency?
Arguments
A single value.
Range: 35 MHz to 250 MHz.
*RST sets this to 35 MHz.
Returns
Examples
A single value.
CLOCK:EREFERENCE:FREQUENCY 35E6
*OPC?
sets the expected reference frequency applied to the Reference In connector to
be 35 MHz. The overlapping command is followed with an Operation Complete
query.
CLOCK:EREFERENCE:FREQUENCY? might return 200.0000000000E+6,
indicating that the expected frequency of the signal applied to the Reference In
connector is set to 200 MHz.
2-88
AWG5200 Series Programmer Manual
Command descriptions
CLOCk:EREFerence:FREQuency:DETect
This command detects the frequency of the signal applied to the Reference In
connector and adjusts the system to use the signal. The frequency is detected
once each time the command executes.
An error message is generated if no frequency is detected, is out of range, or
if the adjustment fails.
This command is only valid when the clock source is external.
Conditions
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
Group
Clock
Syntax
CLOCk:EREFerence:FREQuency:DETect
Examples
CLOCK:EREFERENCE:FREQUENCY:DETECT
*OPC?
detects the clock frequency applied to the Reference In connector. The
overlapping command is followed with an Operation Complete query.
AWG5200 Series Programmer Manual
2-89
Command descriptions
CLOCk:EREFerence:MULTiplier
This command sets or returns the multiplier rate of the variable external reference
signal.
Conditions
Setting the external reference multiplier rate forces the external reference divider
rate to a value of 1.
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
Group
Clock
Syntax
CLOCk:EREFerence:MULTiplier
CLOCk:EREFerence:MULTiplier?
Arguments
A single value.
Range:
Min = 1. Max: Multiplier * External Reference must be ≤ to the maximum
sample rate of the instrument.
*RST sets this to 1.
Returns
Examples
A single value.
CLOCK:EREFERENCE:MULTIPLIER 50
*OPC?
sets the multiplier to 50. The overlapping command is followed with an Operation
Complete query.
CLOCK:EREFERENCE:MULTIPLIER? might return 100, indicating that the
external clock multiplier rate is set to 100.
2-90
AWG5200 Series Programmer Manual
Command descriptions
CLOCk:JITTer
This command 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.
When enabled, the chosen sample rate value will be adjusted to achieve the best
performance.
Conditions
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Clock
Syntax
CLOCk:JITTer {0|1|OFF|ON}
Arguments
0 or OFF disables jitter reduction.
1 or ON enables jitter reduction.
*RST sets this to 0.
Returns
Examples
A single value.
CLOCK:JITTER ON
enables the jitter reduction mode for system clock.
CLOCK:JITTER? might return 0, indicating that the jitter reduction mode is not
enabled for the system clock.
AWG5200 Series Programmer Manual
2-91
Command descriptions
CLOCk:OUTPut:FREQuency? (Query Only)
This command returns the frequency at Clock Out connector. The Clock Out
frequency matches the clock rate.
Group
Clock
Syntax
CLOCk:OUTPut:FREQuency?
Returns
A single value.
A value between 2.5 GHz and 5 GHz is returned, depending on the sample rate.
Examples
2-92
CLOCK:OUTPUT:FREQUENCY? might return 4.0000000000E+9, indicating that
the frequency at the clock output connector is 4 GHz.
AWG5200 Series Programmer Manual
Command descriptions
CLOCk:OUTPut[:STATe]
This command sets or returns the state of the output clock (enabled or disabled).
Enabling Clock Out provides a high speed clock (that is related to sample rate)
to drive other devices or to measure.
Conditions
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Clock
Syntax
CLOCk:OUTPut[:STATe] {0|1|OFF|ON}
CLOCk:OUTPut[:STATe]?
Related Commands
Arguments
CLOCk:SOURce
A single value.
0 or OFF disables the clock out.
1 or ON enables the clock out.
*RST sets this to 0.
Returns
Examples
A single value.
CLOCK:OUTPUT:STATE ON
sets the Clock Output to ON.
CLOCK:OUTPUT:STATE? might return 1, indicating that the output clock is
enabled.
AWG5200 Series Programmer Manual
2-93
Command descriptions
CLOCk:PHASe[:ADJust[:DEGRees]]
This command sets or returns the phase adjustment, in units of degrees, to
synchronize multiple AWGs when using an external trigger. Setting the phase
adjusts the phase of all signal outputs relative to the system clock.
Conditions
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Clock
Syntax
CLOCk:PHASe[:ADJust[:DEGRees]]
CLOCk:PHASe[:ADJust[:DEGRees]]?
Related Commands
CLOCk:SOUT[:STATe]
Arguments
A single value.
Range: –8640 to +8640.
*RST sets this to 0.
Returns
Examples
A single value.
CLOCK:PHASE:ADJUST 100
*OPC?
sets the clock phase to 100 degrees. The blocking command is followed with
an Operation Complete query.
CLOCK:PHASE:ADJUST? might return 1, indicating the clock phase is set to
1 degree.
2-94
AWG5200 Series Programmer Manual
Command descriptions
CLOCk:PHASe[:ADJust]:TIMe
This command sets or returns the phase adjustment, in units of time, to
synchronize multiple AWGs when using an external trigger. Setting the phase
adjusts the phase of all signal outputs relative to the system clock.
Conditions
This is a blocking command. (See page 2-9, Sequential, blocking, and overlapping
commands.)
Group
Clock
Syntax
CLOCk:PHASe[:ADJust]:TIMe
CLOCk:PHASe[:ADJust]:TIMe?
Related Commands
CLOCk:SOUT[:STATe]
Arguments
A single value.
Range is based on the system clock.
At 5 GS/s, the range is ±4.8 ns.
At 2.5 GS/s, the range is 9.6 ns
*RST sets this to 0 s.
Returns
Examples
A single value.
CLOCK:PHASE:ADJUST:TIME 100
*OPC?
sets the clock phase to 100 ps. The blocking command is followed with an
Operation Complete query.
CLOCK:PHASE:ADJUST? might return 1E-12, indicating the clock phase is set
to 1 ps.
AWG5200 Series Programmer Manual
2-95
Command descriptions
CLOCk:SOURce
This command sets or returns the source of the clock.
Conditions
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
Group
Clock
Syntax
CLOCk:SOURce {INTernal|EFIXed|EVARiable|EXTernal}
CLOCk:SOURce?
Arguments
INTernal - Clock signal is generated internally and the reference frequency is
derived from the internal oscillator.
EFIXed – Clock is generated internally and the reference frequency is derived
from a fixed 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. The reference
frequency is deactivated.
*RST sets this to INT.
Returns
Examples
INT, EFIX, EVAR, EXT
CLOCK:SOURCE INTERNAL
*OPC?
sets the clock source to internal. The overlapping command is followed with
an Operation Complete query.
CLOCK:SOURCE? might return EFIX, indicating that the clock source is set to
use the Reference In connector.
2-96
AWG5200 Series Programmer Manual
Command descriptions
CLOCk:SOUT[:STATe]
This command sets or returns the state (enabled or disabled) of the Sync Clock
Out output.
Conditions
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
Group
Clock
Syntax
CLOCk:SOUT[:STATe] {0|1|OFF|ON}
CLOCk:SOUT[:STATe]?
Arguments
0 or OFF disables the Sync Clock Out.
1 or ON enables the Sync Clock Out.
*RST sets this to 0.
Returns
Examples
A single value.
CLOCK:SOUT:STATE 1 sets the Sync Clock Out output to ON.
CLOCK:SOUT:STATE? might return 0, indicating that the Sync Clock Out output
is off.
AWG5200 Series Programmer Manual
2-97
Command descriptions
CLOCk:SRATe
This command sets or returns the sample rate for the clock.
This command is not valid if CLOCk:SOURce is set to EXTernal.
Conditions
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
Group
Clock
Syntax
CLOCk:SRATe
CLOCk:SRATe?
Related Commands
Arguments
CLOCk:SOURce
A single value.
Range:
298 S/s to 2.5 G/s (option 25)
298 S/s to 5 G/s (option 50)
*RST sets this to the maximum value.
Returns
Examples
A single value.
CLOCK:SRATE 5E8
*OPC?
sets the clock sample rate to 500 MS/s. The overlapping command is followed
with an Operation Complete query.
CLOCK:SRATE? might return 2.0000000000E+9, indicating the clock sample
rate is set to 2 GS/s.
2-98
AWG5200 Series Programmer Manual
Command descriptions
*CLS (No Query Form)
This command clears all event registers and queues. (See page 3-1, Status and
events.)
Group
IEEE mandated and optional
Syntax
*CLS
Examples
*CLS clears all the event registers and queues.
AWG5200 Series Programmer Manual
2-99
Command descriptions
CPLayback:CAPTure:FILE (No Query Form)
The command imports baseband IQ waveform data and adds the waveform to the
specified Signal Name in the captured signal list. If the specified Signal Name
does not exist, it is created and added to the captured signal list.
You can import a single IQ file, containing both the I and Q data, or you can
import separate I and Q data files.
When importing a single IQ file, the following file types are supported:
.IQT - RSA3000 Series waveform file format
.TIQ - RSA6000 Series waveform file format
.MAT - MATLAB file format
.TMP - Midas Blue file format
.PRM - Midas Blue file format
When importing individual I and Q data files, the following file types are
supported:
.WFMX - AWG70000 Series waveform file format
.TXT - AWG400/AWG500/AWG600/AWG700/AWG5000/AWG7000 Series
waveform
.WFM - AWG400/AWG500/AWG600/AWG700/AWG5000/AWG7000
Series waveform
.MAT - MATLAB file format
.RFD - RFXpress waveform file format
Conditions
This is an overlapping command. (See page 2-9, Sequential, blocking, and
overlapping commands.)
Group
Capture and playback
Syntax
CPLayback:CAPTure:FILE
,{SIQ|CIQ},[,]
Arguments
::= defines the signal name to be created and added to
the captured signal list.
SIQ sets the command to import separate I and Q waveform files. The I and Q
files are combined into one file during the import and retains the name of the
first specified waveform.
CIQ sets the command to import a combined waveform file containing both
I and Q data.
::=
2-100
AWG5200 Series Programmer Manual
Command descriptions
Examples
CPLAYBACK:CAPTURE:FILE
"chirp",SIQ,"C:\TestFiles\chirp_I.wfmx","C:\TestFiles\
chirp_Q.wfmx" imports the I and Q waveform data files named chirp_I.wfmx
and chirp_Q.wfmx.
CPLAYBACK:CAPTURE:FILE "chirp",CIQ,"C:\TestFiles\chirp.tiq"
imports waveform file chirp.tiq containing both I and Q data.
AWG5200 Series Programmer Manual
2-101
Command descriptions
CPLayback:CAPTure:INSTrument:OSCilloscope (No Query Form)
This command connects to the specified oscilloscope, transfers the existing
acquisition from the oscilloscope to the AWG, and adds it to the specified signal.
If the specified signal does not exist, it is created and added to the captured
signal list.
Group
Capture and playback
Syntax
CPLayback:CAPTure:INSTrument:OSCilloscope
,,,
Arguments
::= Name of the signal to be modified or created.
::= Specifies the host name of the acquisition
instrument to connect to. The host name can be in the form of an IP Address or
a Visa Alias.
::= Specifies the I signal source in the Oscilloscope.
::= Specifies the Q signal source in the Oscilloscope.
Sources can be imported from oscilloscope channels, references, or math
signals.
Channel syntax = where n represents the channel source.
Reference syntax = where n represents the reference signal
source.
Math syntax = where n represents the math signal source.
Examples
CPLAYBACK:CAPTURE:INSTRUMENT:OSCILLOSCOPE "chirp",
"MyDpo","Ch1","Ch2" imports I and Q signal from Channel 1 and Channel 2
(respectively) of the oscilloscope named MyDpo and adds it to the signal named
chirp.
2-102
AWG5200 Series Programmer Manual
Command descriptions
CPLayback:CAPTure:INSTrument:RSA (No Query Form)
This command connects to the specified RSA (Realtime Spectrum Analyzer),
transfers the existing acquisition to the AWG, and adds it to the specified signal. If
the specified signal does not exist, it is created and added to the captured signal list.
Group
Capture and playback
Syntax
CPLayback:CAPTure:INSTrument:RSA
,
Arguments
::= Name of the signal to be modified or created.
::= Specifies the host name of the acquisition
instrument to connect to. The host name can be in the form of an IP Address or
a Visa Alias.
Examples
CPLAYBACK:CAPTURE:INSTRUMENT:RSA "chirp","MyRSA" imports the
signal from that analyzer named MyRSA and adds it to the signal named chirp.
CPLayback:CLISt:NAME? (Query Only)
This command returns the name of a signal from the Captured Signal List in the
position specified by the index value.
Group
Capture and playback
Syntax
CPLayback:CLISt:NAME?
Arguments
Returns
Examples
::=
::= is the signal name specified by .
CPLAYBACK:CLIST:NAME? 1 might return "Signal_1", indicating that the file
named Signal_1 is the first file listed in the Captured Signal List.
AWG5200 Series Programmer Manual
2-103
Command descriptions
CPLayback:CLISt:SIGNal:DELete (No Query Form)
This command removes the specified signal from the Captured Signal List.
Group
Capture and playback
Syntax
CPLayback:CLISt:SIGNal:DELete {ALL|signal_name}
Arguments
ALL - Removes all signals from the Captured Signal List.
::=
Examples
2-104
CPLAYBACK:CLIST:SIGNAL:DELETE "Signal_1" removes the signal named
Signal_1 from the Captured Signal List.
AWG5200 Series Programmer Manual
Command descriptions
CPLayback:CLISt:SIGNal:SCOMpile
This command selects or deselects a signal from the captured signal list to be
compiled. Single signals are selected with the command but more than one signal
can be selected for compilation by sending multiple commands. Signals remain
selected until deselected with this command.
The query form returns the list of selected signals.
Group
Capture and playback
Syntax
CPLayback:CLISt:SIGNal:SCOMpile ,{OFF|ON|1|0}
CPLayback:CLISt:SIGNal:SCOMpile?
Arguments