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.
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.
Warranty
Tektronix warrants that the product will be free from defects in materials and workmanship for a period of three (3)
years from the date of original purchase from an authorized Tektronix distributor. If the product proves defective
during this warranty period, Tektronix, at its option, either will repair the defective product without charge for parts
and labor, or will provide a replacement in exchange for the defective product. Parts, modules and replacement
products used by Tektronix for warranty work may be new or
parts, modules and products become the property of Tektronix.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration
of the warranty period and make suitable arrangements for the performance of service. Customer shall be
responsible for packaging and shipping the defective product to the service center designated by Tektronix,
shipping charges prepaid, and with a copy of customer proof of purchase. Tektronix shall pay for the return of the
product to Customer if the shipment is to a location within the country in which the Tektronix service center is
located. Customer shall be responsible for paying all shipping charges, duties, taxes, and any other charges for
products returned to any other locations.
This warranty shall not apply to any defect, failure or damage caused by improper use or improper or inadequate
maintenance and care. Tektronix shall not be obligated to furnish service under this warranty a) to repair damage
resulting from attempts by personnel other than Tektronix representatives to install, repair or service the product;
b) to repair damage resulting from improper use or connection to
or malfunction caused by the use of non-Tektronix supplies; or d) to service a product that has been modified or
integrated with other products when the effect of such modification or integration increases the time or difficulty of
servicing the product.
reconditioned to like new performance. All replaced
incompatible equipment; c) to repair any damage
THIS WARRANTY IS GIVEN BY TEKTRONIX WITH RESPECT TO THE PRODUCT IN LIEU OF ANY
OTHER WARRANTIES, EXPRESS OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
TEKTRONIX' RESPONSIBILITY TO REPAIR OR REPLACE DEFECTIVE PRODUCTS IS THE SOLE AND
EXCLUSIVE REMEDY PROVIDED TO THE CUSTOMER FOR BREACH OF THIS WARRANTY.
TEKTRONIX AND ITS VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT, SPECIAL, INCIDENTAL,
OR CONSEQUENTIAL DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX OR THE VENDOR HAS
ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.
[W2 – 15AUG04]
i
AFG1000 Series Arbitrary Function Generator Programmer Manual
Table of contents
Getting Started ....................................................................................................................................... 1
Connecting the Interface .......................................................................................................................... 1
Using TekVISA ....................................................................................................................................... 1
Where to find more information .............................................................................................................. 2
Syntax and Commands ........................................................................................................................... 3
Index .................................................................................................................................................... 68
AFG1000 Series Arbitrary Function Generator Programmer Manual
1
AC line
connector
USB
(
type
B
)
connector
Getting Started
Introduction
This programmer guide provides information to use commands for remotely
controlling your instrument. With this information, write computer programs that will
perform functions such as setting the front-panel controls, selecting clock source,
setting sampling rate, and exporting data for use in other programs.
Connecting the Interface
The AFG1000 Series has a USB (type B) connector on the rear panel, as shown
in the following figure. This connector conforms to USB-TMC. Attach a USB
cable to this connector.
Figure 1: USB (type B) connector
Using TekVISA
TekVISA is Tektronix implementation of VISA (Virtual Instrument Software
Architecture), an industry-standard communication protocol. VISA provides
a common standard for software developers so that software from multiple
vendors, such as instrument drivers, can run on the same platform. TekVISA is
industry-compliant software, available with selected Tektronix instruments.
Use this software to write (or draw) interoperable instrument drivers in a
variety of Application Development Environments (ADEs). It implements a
subset of Version 2.2 of the VISA specification for controlling USB
instrument interface locally.
2
AFG1000 Series Arbitrary Function Generator Programmer Manual
Getting Started
Item
Purpose
Location
Important
safety and
compliance
instructions
Compliance and
safety instructions
Built-in
Help
UI Help and
Operation
Quick Start
User
Unpacking, Installation,
T
and
Programmer
Manu
Menu Structures,
User
Interface,
and
Information
Technical
Reference
Specifications
and
performance
ver
Installation
Use an internet browser to access the Tektronix Web site
(www.tek.com/downloads)
Unzip the downloaded file in a
Setup.exe.
NOTE: The details on TekVISA concepts and operations are explained in the
TekVISA Programmer Manual that can be also found on the Tektronix Web site.
Where to find more information
The following table lists related documentation available for your instrument.
The documentation is available on the Product Documentation CD and on the
Tektronix Web site (www.tek.com/manuals).
and download the current TekVISA to your PC.
temporary directory of your choice and run
Manual
al
utorials, Operation,
Overviews
Programming
ification
procedures
AFG1000 Series Arbitrary Function Generator Programmer Manual
3
Syntax and Commands
Command Syntax
Control the operations and functions of the instrument through the USB
interface using commands and queries. The related topics listed below
the syntax of these commands and queries. The topics also describe the
conventions that the instrument uses to process them. See Command Groups
(See page 10.) for a listing of the commands by command group, or use the
index to locate a specific command.
Backus-Naur Form Definition
describe
This manual describes commands and queries using the Backus-Naur Form
(BNF) notation. The following table defines the standard BNF symbols.
Table 1: BNF symbols and meanings
Symbol
< >
:=
|
{ } Group; one element is required
[ ] Optional; can be omitted
. . .
( ) Comment
Command and Query Structure
Overview
Commands consist of set commands and query commands (usually simply called
commands and queries). Commands change instrument settings or perform a
specific action. Queries cause the instrument to return data and information about
its status.
Most commands have both a set form and a query form. The query form of the
command is the same as the set
For example, the set command
MMEMory:CDIRectory?. Not all commands have both a set and a query form;
some commands are set only and some are query only.
Meaning
Defined element
Is defined as
Exclusive OR
Previous element(s) may be repeated
form except that it ends with a question mark.
MMEMory:CDIRectory has a query form
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 consist of five element types.
4
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Syntax
Table 2: Command message elements
Symbol
<Header>
Meaning
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 comman
d is concatenated with other commands the beginning
is required. The beginning colon can never be used with command
<Mnemonic>
headers beginning with a star (*).
A header subfunction. Some command headers have only one mnemonic.
If a command
from each other by a colon (:) character.
header has multiple mnemonics, they are always separated
<Argument> A quantity, quality, restriction, or limit associated with the header. Not
all commands have an argument, while other commands have multiple
arguments. Arguments are separated from the header by a <Space>.
Arguments are separated from each other by a <Comma>.
<Comma> A single comma between arguments of multiple-argument commands. It
may optionally have white space characters before and after the comma.
<Space> A white space character between command header and argument. It may
optionally consist of multiple white space characters.
colon
Commands
Commands cause the instrument to perform a specific function or change one of
its settings. Commands have the structure:
A command header is made up 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 of 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
Query Responses
Queries cause the instrument to return information about its status or settings.
Queries have the structure:
Specify a query at any level within the command tree unless otherwise noted.
These branch queries return information about all the mnemonics
below the
specified branch or level.
When a query is sent to the instrument, only the values are returned. When the
returned value is a mnemonic, it is noted in abbreviated format.
AFG1000 Series Arbitrary Function Generator Programmer Manual
5
Command Syntax
Command Entry
Follow these general rules when entering commands:
Enter commands in upper or lower case.
Precede any command with white space characters. White space
include any combination of the ASCII control characters 00 through
0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal).
The instrument ignores commands that consists of just a combination of white
space characters and line feeds.
SCPI Commands and Queries
The instrument 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. The top level of
the tree is the root
Create commands and queries from these subsystem hierarchy trees.
specify actions for the instrument to perform. Queries return
and information about parameter settings.
Creating Commands
SCPI commands are created by stringing together the nodes of a subsystem
hierarchy and separating each node by a colon.
node; it is followed by one or more lower-level nodes.
Commands
measurement data
characters
09 and
To create
structure adding nodes until you reach the
some queries have parameters; you must
you specify a parameter value that is out
default value. The command descriptions,
parameters.
Creating Queries
Query Responses
Parameter Types
To create a query, start at the root node of a tree structure, move down to the end of
a branch, and add a question mark.
The query causes the instrument to return information about its status or settings.
When a query is sent to the instrument, only the values are returned. When the
returned value is a mnemonic, it is noted in abbreviated format.
Every parameter in the command and query descriptions is of a specified type.
(See Table 3.) The parameters are enclosed in brackets, such as <value>.
a SCPI command, start with the root node and move down the tree
end of a branch. Most commands and
include a value for these parameters. If
of range, the parameter will be set to a
list the valid values for all
6
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Syntax
Parameter type
Description
Example
arbitrary block
1
A specified length of
arbitrary
#512234xxxxx . . . where
5
5
length
xxxxx
#0xxxxx...<LF><&EOI>
boolean
Boolean numbers or values
ON or ≠ 0
OFF or 0
discrete
A list of specific values
MIN, MAX
binary
Binary numbers
#B0110
octal
Octal numbers
#Q57, #Q3
hexadecimal
2
Hexadecimal numbers
(0-9, A, B, C, D, E, F)
#H AA, #H1
NR1 2 numeric
Integers
0, 1, 15, -1
NR2
2 3
numeric
Decimal numbers
1.2, 3.141516, -6.5
NR3 2 numeric
Floating point numbers
3.1415E-9, -16.1E5
NRf 2 numeric
Flexible decimal number that
may be type NR1, NR2 or NR3
See NR1, NR2, and NR3
examples
string
4
Alphanumeric characters (must
be within quotation marks)
"Testing 1, 2, 3"
The parameter type is listed after the parameter and is enclosed in parentheses,
for example, (boolean). Some parameter types are defined specifically for the
instrument command set and some are defined by SCPI.
Table 3: Parameter types used in syntax descriptions
data
indicates that the following
digits (12234) specify the
of the data in bytes;
... indicates the data
or
1
Defined in ANSI/IEEE 488.2 as "Definite Length Arbitrary Block Response Data."
2
An ANSI/IEEE 488.2-1992-defined parameter type.
3
Some commands and queries will accept an octal or hexadecimal value even though the parameter type is
defined as NR1.
4
Defined in ANSI/IEEE 488.2 as "String Response Data."
Special Characters
The Line Feed (LF) character or the New Line (NL) character (ASCII 10), and all
characters in the range of ASCII 127-255 are defined as special characters. These
characters are used in arbitrary block arguments only; using these characters in
other parts of any command yields unpredictable results.
AFG1000 Series Arbitrary Function Generator Programmer Manual
7
Command Syntax
Abbreviating Commands,
Queries, and Parameters
Chaining Commands and
Queries
Abbreviate most SCPI commands, queries, and parameters to an accepted short
form. This manual shows these short forms as a combination of upper and
case letters. The upper case letters indicate the accepted short form of a
command. As shown in the following figure, create a short form by using only
the upper case letters. The accepted short form and the long form are
equivalent
and request the same action of the instrument.
Figure 2: Example of abbreviating a command
NOTE: The numeric suffix of a command or query may be included in either the
long form or short form; the instrument will default to "1" if no suffix is used.
Chain several commands or queries together into a single message. To create a
chained message, first create a command or query, add a semicolon (;), and then
add more commands or queries and semicolons until the message is complete.
If the command following a semicolon is a root node, precede it with a colon
(:).The single chained message should end in a
semicolon. Responses to any queries in your message
semicolons.
command or query, not a
are separated by
lower
If a command or query has the same root and lower-level nodes as the previous
command or query, you can omit these nodes.
Unit and SI Prefix
If the decimal numeric argument refers to amplitude, frequency, or time, express
it using SI units instead of using the scaled explicit point input value
<NR3>. (SI units are units that conform to the Systeme International
standard.) For example, use the input format 200 mV or 1.0 MHz
200.0E-3 or 1.0E+6, respectively, to
specify voltage or frequency.
format
d'Unites
instead of
8
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Syntax
The following table lists the available units.
Table 4: Available units
General rules for using
SCPI commands
Symbol Meaning
DEG
degree (phase)
Hz hertz (frequency)
PCT
s
V
Vpp
percent (%)
second (time)
volt
volt
You can omit a unit in a command, but you must include the unit when using a SI
prefix. For example, frequency of 15 MHz can be described as follows
15.0E6, 1.5E7Hz, 15000000, 15000000Hz, 15MHz, etc.
("15M" is not allowed.)
Here are three general rules for using SCPI commands, queries, and parameters:
Use single (‘ ’) or double (“ ”) quotation marks for quoted strings, but
use both types of quotation marks for the same string.
correct
correct
"This string uses quotation marks correctly."
‘This
string also uses quotation marks correctly.'
you cannot
incorrect
Use upper case, lower case, or a mixture of both cases for all
"This
string does not use quotation marks correctly.'
commands, queries,
and parameters.
SOURCE1:FREQUENCY 10MHZ
is the same as
NOTE: Literal strings (quoted) are case sensitive, for example, file names.
source1:frequency 100mhz
and
SOURCE1:frequency 10MHZ
No embedded spaces are allowed between or within nodes.
correct
incorrect
SOURCE1:FREQUENCY 10MHZ
SOURCE1: FREQUENCY 10MHZ
AFG1000 Series Arbitrary Function Generator Programmer Manual
9
Command Syntax
IEEE 488.2 Common Commands
Description
Command and Query
Structure
ANSI/IEEE Standard 488.2 defines the codes, formats, protocols, and usage of
common commands and queries used on the interface between the controller and
the instruments. The instrument complies with this standard.
The syntax for an IEEE 488.2 common command is an asterisk (*) followed by a
command and, optionally, a space and parameter value. The syntax for an IEEE
488.2 common query is an asterisk (*) followed by a query and a question mark.
All of the common commands and queries are listed in the last part of the Syntaxand Commands section. The following are examples of common commands:
*CLS
The following are examples of common queries
*IDN?
10
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Groups
Memory Commands
Mass Memory Commands
Output Commands
This section lists the commands organized by functional group. The Command
Descriptions section lists all commands alphabetically. (See page 14.)
Memory commands let you change setup memory attributes. The following table
lists and describes Memory commands.
Table 5: Memory commands
Command
*RCL
*SAV
Description
Recall instrument setting from setup memory
Save instrument setting to setup memory
Mass Memory commands let you change mass memory attributes. The
following table lists and describes the Mass Memory commands.
Table 6: Mass Memory commands
Command
MMEMory:CATalog?
MMEMory:CDIRectory
MMEMory:DELete
Description
Query the status of mass memory
Set/query current directory
Delete file or directory in mass memory
Output commands let you set output attributes. The following table lists and
describes the Output commands.
Table 7: Output commands
Command
OUTPut[1|2]:IMPedance
OUTPut[1|2][:STATe]
Description
Set/query impedance
Set/query output on or off
AFG1000 Series Arbitrary Function Generator Programmer Manual
11
Command Groups
Source Commands
Source commands let you set waveform output parameters. The following table
lists and describes the Source commands.
Table 8: Source commands
Command
[SOURce[1|2]]:AM[:DEPTh]
[SOURce[1|2]]:AM:INTernal:FREQuency
[SOURce[1|2]]:AM:INTernal:FUNCtion
[SOURce[1|2]]:AM:INTernal:FUNCtion:EFILe
[SOURce[1|2]]:AM:SOURce
[SOURce[1|2]]:AM:STATe
[SOURce[1|2]]:ASKey[:AMPLitude]
[SOURce[1|2]]:ASKey:INTernal:RATE
[SOURce[1|2]]:ASKey:SOURce
[SOURce[1|2]]:ASKey:STATe
[SOURce[1|2]]:BURSt:MODE
[SOURce[1|2]]:BURSt:NCYCles
[SOURce[1|2]]:BURSt:SOURce
[SOURce[1|2]]:BURSt:STATe
[SOURce[1|2]]:FM[:DEViation]
[SOURce[1|2]]:FM:INTernal:FREQuency
[SOURce[1|2]]:FM:INTernal:FUNCtion
[SOURce[1|2]]:FM:INTernal:FUNCtion:EFILe
[SOURce[1|2]]:FM:SOURce
[SOURce[1|2]]:FM:STATe
[SOURce[1|2]]:FREQuency:CENTer
[SOURce[1|2]]:FREQuency:CONCurrent
[SOURce[1|2]]:FREQuency[:CW|:FIXed]
[SOURce[1|2]]:FREQuency:MODE
[SOURce[1|2]]:FREQuency:SPAN
[SOURce[1|2]]:FREQuency:STARt
[SOURce[1|2]]:FREQuency:STOP
[SOURce[1|2]]:FSKey[:FREQuency]
[SOURce[1|2]]:FSKey:INTernal:RATE
[SOURce[1|2]]:FSKey:SOURce
[SOURce[1|2]]:FSKey:STATe
[SOURce[1|2]]:FUNCtion:EFILe
[SOURce[1|2]]:FUNCtion[:SHAPe]
[SOURce[1|2]]:PHASe[:ADJust]
[SOURce[1|2]]:PHASe:INITiate
Description
Set/query amplitude modulation depth
Set/query internal modulation frequency
Set/query internal modulation waveform
Set/query EFILe setting
Set/query amplitude modulation source
Set/query amplitude modulation status
Set/query ASK depth
Set/query ASK internal modulation rate
Set/query ASK source
Set/query ASK status
Set/query burst mode
Set/query burst mode waveform output cycle
Set/query burst mode trigger source
Set/query burst mode status
Set/query frequency deviation
Set/query internal modulation frequency
Set/query internal modulation waveform
Set/query EFILe setting
Set/query frequency modulation source
Set/query frequency modulation status
Set/query center frequency
Set/query concurrent change of frequency
Set/query output waveform frequency
Set/query sweep status
Set/query sweep frequency span
Set/query sweep start frequency
Set/query sweep stop frequency
Set/query FSK hop frequency
Set/query FSK internal modulation rate
Set/query FSK source
Set/query FSK status
Set/query EFILe name
Set/query output waveform
Set/query output waveform phase
Initiate output waveform phase synchronization
12
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Groups
Table 8: Source commands (cont.)
Command
[SOURce[1|2]]:PM[:DEViation]
[SOURce[1|2]]:PM:INTernal:FREQuency
[SOURce[1|2]]:PM:INTernal:FUNCtion
[SOURce[1|2]]:PM:INTernal:FUNCtion:EFILe
[SOURce[1|2]]:PM:SOURce
[SOURce[1|2]]:PM:STATe
[SOURce[1|2]]:PSKey[:DEViation]
[SOURce[1|2]]:PSKey:INTernal:RATE
[SOURce[1|2]]:PSKey:SOURce
[SOURce[1|2]]:PSKey:STATe
[SOURce[1|2]]:PULSe:DCYCle
[SOURce[1|2]]:PWM:INTernal:FREQuency
[SOURce[1|2]]:PWM:INTernal:FUNCtion
[SOURce[1|2]]:PWM:INTernal:FUNCtion:EFILe
[SOURce[1|2]]:PWM:SOURce
[SOURce[1|2]]:PWM:STATe
[SOURce[1|2]]:PWM[:DEViation]:DCYCle
[SOURce[1|2]]:SWEep:SOURce
[SOURce[1|2]]:SWEep:SPACing
[SOURce[1|2]]:SWEep:TIME
[SOURce[1|2]]:VOLTage[:LEVel]
Description
Set/query phase modulation deviation
Set/query internal modulation frequency
Set/query internal modulation waveform
Set/query EFILe setting
Set/query phase modulation source
Set/query phase modulation status
Set/query PSK deviation
Set/query PSK internal modulation rate
Set/query PSK source
Set/query PSK status
Set/query pulse waveform duty cycle
Set/query pulse width modulation frequency
Set/query pulse width modulation waveform
Set/query EFILe name
Set/query pulse width modulation source
Set/query pulse width modulation status
Set/query pulse width modulation deviation
Set/query sweep trigger source
Set/query sweep spacing
Set/query sweep time
Set/query output offset voltage
[:IMMediate]: OFFSet
[SOURce[1|2]]:VOLTage[:LEVel]
Set/query output amplitude
[:IMMediate][: AMPLitude]
Status Commands
Status commands let you determine the status of the instrument. The following
table lists and describes the Status commands.
Table 9: Status commands
Command
*CLS
System Commands
System commands let you control miscellaneous instrument functions. The
following table lists and describes the System commands.
Table 10: System commands
Command
*IDN?
*OPT?
*RST
SYSTem:ERRor[:NEXT]? Return error event queue
Description
Clear all event registers and queues
Description
Return identification information
Return option information
Reset
AFG1000 Series Arbitrary Function Generator Programmer Manual
13
Command Groups
Synchronization Commands
Trace Commands
Trigger Command
Synchronization commands let you synchronize the operation of the
instrument. The following table lists and describes the
Synchronization
commands.
Table 11: Synchronization commands
Command
*WAI Wait to continue
Description
Trace commands let you set the edit memory and user waveform memory. The
following table lists and describes the Trace commands.
Table 12: Trace commands
Command
TRACe|DATA:CATalog?
TRACe|DATA:COPY
TRACe|DATA[:DATA] Set/query waveform data to edit memory
TRACe|DATA[:DATA]:VALue
TRACe|DATA:POINts Set/query number of points for waveform
Description
Return user waveform memory status
Copy edit memory (or user waveform
memory) content to user waveform memory
(or edit memory)
Set/quer
y waveform data in edit memory
data in edit memory
Trigger command lets you control the arbitrary function generator triggering.
Table 13: Trigger command
Command
*TRG
Description
Force trigger event
AFG Control
AFG Control command copies setups between two channels.
Table 14: AFG Control command
Command
AFGControl:CSCopy
Description
Copy CH1 (or CH2) setup parameters to CH2 (or CH1)
14
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
Commands either set or query instrument values. Some commands both set and
query, some only set, and some only query.
Manual Conventions
This manual uses the following conventions:
No Query Form indicates set-only commands
A question mark (?) appended to the commands and Query Only indicates
query-only commands
Fully spells out headers, mnemonics, and arguments with the minimal
spelling shown in upper case; for example, to use the abbreviated form of the
DISPlay:BRIGhtness command, just type DISP:BRIG
Syntax of some commands varies, depending on the model of instrument
you are using; differences are noted
AFGControl:CSCopy (No Query Form)
This command copies setup parameters for one channel to another channel.
Group
AFG Control
Syntax
AFGControl:CSCopy {CH1|CH2},{CH1|CH2}
Arguments
CH1|CH2
Examples
AFGControl:CSCopy CH1,CH2
copies the CH1 setup parameters into CH2.
*CLS (No Query Form)
This command clears all the event registers and queues, which are used in the
instrument status and event reporting system.
Group
Status
AFG1000 Series Arbitrary Function Generator Programmer Manual
15
Command Descriptions
Syntax
Arguments
Examples
*IDN? (Query Only)
Group
Syntax
Arguments
*CLS
None
*CLS
clears all the event registers and queues.
This query-only command returns identification information on the instrument.
The first <NR1> indicates that the total amount of storage currently used, in bytes.
The second <NR1> indicates that the free space of mass storage, in bytes.
<file_name> is the name of directory or file. If the name exceeds 22 characters in
length, it will be shortened to 8 characters (without suffix) in 8.3 name format.
<file_type> is DIR for directory, otherwise it is blank.
Examples
MMEMory:CDIRectory
Group
Syntax
<file_size> is the size of the file, in bytes. This value will be 0 for directory.
The USB memory includes the Case and PWS4000-Main-CPU-Update folders, a
SAMPLE1.tfw file, and a Test.zip file. The directory name PWS4000-Main-CPUUpdate will be shortened to PWS400~1.
MMEMory:CATalog? might return the following response:
<directory_name>::=<string> indicates the current working directory for the
AFG1000 Series Arbitrary Function Generator Programmer Manual
17
Command Descriptions
mass storage system.
Returns
<directory_name>::=<string>
Examples
MMEMory:CDIRectory ”/AFG/WORK0”
changes the current directory to /AFG/WORK0.
MMEMory:DELete (No Query Form)
This command deletes a file or directory from the mass storage system. If a
specified file in the mass storage is not allowed to overwrite or delete, this
command causes an error. You can delete a directory if it is empty.
Group
Syntax
Arguments
Examples
Mass Memory
MMEMory:DELete <file_name>
<file_name>::=<string> specifies a file to be deleted and should include full path.
MMEMory:DELete ”/AFG/WORK0/TEK001.tfw”
*OPT? (Query Only)
Group
Syntax
Arguments
deletes the specified file from the /AFG/WORK directory.
This query-only command returns a list of the options installed in your instrument.
System
*OPT?
None
18
Command Descriptions
AFG1000 Series Arbitrary Function Generator Programmer Manual
Returns
Examples
OUTPut[1|2]:IMPedance
Group
Syntax
Arguments
<OPT>[,<OPT>[,<OPT>[,<OPT>]]]
*OPT?
might return 0, which indicates no option is installed in the instrument.
This command sets the output load impedance for the specified channel. The
specified value is used for amplitude, offset, and high/low
set the impedance to any value from 1 Ω to 10 kΩ with a
default value is 50 Ω.
The query returns the current load impedance setting
impedance is set to INFinity, the query returns
This command restores the state of the instrument from a copy of the settings
stored in the setup memory. The settings are stored using the *SAV command. If
the specified setup memory is deleted, this command causes an error.
Memory
*RCL {0|1|2|…|30|31}
*SAV
0, 1, 2, … 30, or 31 specifies the location of setup memory.
*RCL 3
restores the instrument from a copy of the settings stored in memory location 3.
20
Command Descriptions
AFG1000 Series Arbitrary Function Generator Programmer Manual
*RST (No Query Form)
Group
Syntax
Arguments
Examples
*SAV (No Query Form)
Group
Syntax
Related Commands
Arguments
Examples
This command resets the instrument to the factory default settings.
System
*RST
None
*RST
resets the instrument settings to the factory defaults.
This command stores the current settings of the arbitrary function generator to a
specified setup memory location.
Memory
*SAV {0|1|2|…|30|31}
*RCL
0, 1, 2, … 30, or 31 specifies the location of setup memory.
*SAV 2
saves the current instrument state in the memory location 2.
AFG1000 Series Arbitrary Function Generator Programmer Manual
21
Command Descriptions
[SOURce[1|2]]:AM[:DEPTh]
This command sets or queries the modulation depth of AM modulation for the
specified channel. Set the modulation depth from 0% to 100% with resolution of
1%.
Conditions
Group
For the AFG1022, use
not apply to CH2 for the AFG1022.
MINimum sets the modulation depth to minimum value.
[MINimum|MAXimum]
MAXimum sets the modulation depth to maximum value.
Returns
Examples
<depth>
SOURce1:AM:DEPth MAXimum
sets the depth of modulating signal on CH 1 to the maximum value.
[SOURce[1|2]]:AM:INTernal:FREQuency
This command sets or queries the internal modulation frequency of AM
modulation for the specified channel. Use this command when the internal
modulation source is selected. Set the internal modulation
mHz to 20.00 kHz with resolution of 1 mHz.
Conditions
For the AFG1022, use
not apply to CH2 for the AFG1022.
[SOURce1]
frequency from 2
. Modulation, sweep, and burst conditions do
22
AFG1000 Series Arbitrary Function Generator Programmer Manual
AFG1000 Series Arbitrary Function Generator Programmer Manual
23
Command Descriptions
Arguments
USER<NR1>
|EMEMory
<NR1> specifies the user waveform memory location.
For the AFG1022, <NR1> can be any number from 0 to 255.
For the AFG1062, <NR1> can be any number from 0 to 31.
A user defined waveform saved in the user waveform memory or the
EMEMory
EFILe
can be selected as a modulating signal.
EFILe is used as a modulating signal.
Returns
SIN|SQU|RAMP|PRN|USER<NR1>|EMEMory|EFILe
Examples
SOURce1:AM:INTernal:FUNCtion SQUare
selects Square as the shape of modulating waveform for the CH 1 output.
[SOURce[1|2]]:AM:INTernal:FUNCtion:EFILe
This command sets or queries an EFILe name used as a modulating waveform for
AM modulation. A file name must be specified in the mass storage system. This
command returns “ ” if there is no file in the mass storage.
MINimum sets the modulation amplitude to minimum value.
26
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
MAXimum sets the modulation amplitude to maximum value.
Returns
Examples
<amplitude>
SOURce1:ASKey:AMPLitude MAXimum
sets the amplitude of modulating signal on CH 1 to the maximum value.
[SOURce[1|2]]:ASKey:INTernal:RATE
This command sets or queries the internal modulation rate of ASK modulation
for the specified channel. Use this command when the internal modulation
source is selected.
INTernal means that the carrier waveform is modulated with an internal source.
EXTernal means that the carrier waveform is modulated with an external source.
INT|EXT
SOURce1:ASKey:SOURce INTernal
sets the CH 1 source of modulating signal to internal.
[SOURce[1|2]]:ASKey:STATe
This command enables or disables ASK modulation. The query returns the state
of ASK modulation. Select a sine, square, ramp, or arbitrary
carrier waveform.
TRIGgered means that triggered mode is selected for burst mode.
GATed means that gated mode is selected for burst mode.
TRIG|GAT
SOURce1:BURSt:MODE TRIGgered
[SOURce1]
. Modulation, sweep, and burst conditions do
[SOURce[1|2]]:BURSt:NCYCles
Conditions
selects triggered mode.
This command sets or queries the number of cycles (burst count) to be output in
burst mode for the specified channel. The query returns 9.9E+37 if the burst
count is set to INFinity.
For the AFG1022, use
[SOURce1]
. Modulation, sweep, and burst conditions do
AFG1000 Series Arbitrary Function Generator Programmer Manual
<NRf> is the burst count. The burst count ranges from 1 to 1,000,000.
INFinity sets the burst count to infinite count.
MINimum sets the burst count to minimum count.
MAXimum sets the burst count to maximum count.
Returns
Examples
<cycles>
SOURce1:BURSt:NCYCles 2
sets the CH 1 burst count to 2.
[SOURce[1|2]]:BURSt:SOURce
{MINimum|MAXimum}
This command sets or queries the trigger source in the burst mode for the
specified channel. This command is available only in the Triggered burst mode.
This command sets or queries the peak frequency deviation of FM modulation for
the specified channel. The setting range of frequency deviation depends on the
waveform selected as the carrier. For more information, refer to the AFG1000
Series
Specifications and Performance Verification Technical Reference.
AFG1000 Series Arbitrary Function Generator Programmer Manual
This command sets or queries the internal modulation frequency of FM
modulation for the specified channel. Use this command when the internal
modulation source is selected.
Set the internal modulation frequency from 2 mHz to 20.00 kHz with resolution
of 1 mHz.
Conditions
Group
Syntax
For the AFG1022, use
not apply to CH2 for the AFG1022.
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
Arguments
<frequency>::=<NRf>[<units>]
where:
<NRf> is the modulation frequency.
<units>::=[Hz | kHz | MHz]
Returns
<frequency>
Examples
SOURce1:FM:INTernal:FREQuency 10kHz
sets the CH 1 internal modulation frequency to 10 kHz.
[SOURce[1|2]]:FM:INTernal:FUNCtion
This command sets or queries the modulating waveform of FM modulation for the
specified channel. Use this command when the internal modulation source is
selected.
If you specify EFILe when there is no EFILe or the EFILe is not yet defined,
this command causes an error.
<NR1> specifies the user waveform memory location.
For the AFG1022, <NR1> can be any number from 0 to 255.
For the AFG1062, <NR1> can be any number from 0 to 31.
A user defined waveform saved in the user waveform memory or the
EMEMory
EFILe
|EMEMory
can be selected as a modulating signal.
AFG1000 Series Arbitrary Function Generator Programmer Manual
33
Command Descriptions
EFILe is used as a modulating signal.
Returns
SIN|SQU|RAMP|PRN|USER<NR1>|EMEMory|EFILe
Examples
SOURce1:FM:INTernal:FUNCtion SQUare
selects Square as the shape of modulating waveform for the CH 1 output.
[SOURce[1|2]]:FM:INTernal:FUNCtion:EFILe
This command sets or queries an EFILe name used as a modulating waveform
for
FM modulation. A file name must be specified in the mass storage system.
This
command returns “ ” if there is no file in the mass storage.
Conditions
Group
Syntax
Arguments
For the AFG1022, use
not apply to CH2 for the AFG1022.
AFG1000 Series Arbitrary Function Generator Programmer Manual
35
Command Descriptions
[SOURce[1|2]]:FREQuency:CENTer
This command sets or queries the center frequency of sweep for the specified
channel. This command is always used with the
[SOURce[1|2]]:FREQuency:SPAN
frequency depends on the waveform
Conditions
For the AFG1022, use
not apply to CH2 for the AFG1022.
This command enables or disables the function to copy the frequency (or period)
of one channel to another channel.
The[SOURce[1|2]]:FREQuency:CONCurrent command copies the frequency
period) of the channel specified by the header suffix to another channel. If you
(or
specify CH 1 with the header, the CH 1 frequency will be copied to CH 2.
36
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
When the concurrent copy function is enabled, the FreqLock function is also
enabled automaticlly. Use general knob to adjust frequency (or period) of the two
channels sychronously.
The
[SOURce[1|2]]:FREQuency:CONCurrent?
command returns “0” (off) or “1”
(on).
Group
Syntax
[SOURce[1|2]]:FREQuency:CONCurrent
Source
{ON|OFF|<NR1>}
[SOURce[1|2]]:FREQuency:CONCurrent?
ON or <NR1>≠0 enables the concurrent copy function.
Arguments
OFF or <NR1>=0 disables the concurrent copy function.
Returns
Examples
<NR1>
SOURce1:FREQuency:CONCurrent ON
copies the frequency value of CH 1 to CH 2.
[SOURce[1|2]]:FREQuency[:CW|:FIXed]
This command sets or queries the frequency of output waveform for the specified
channel. This command is available when the Run Mode is set to other than
Sweep.
The setting range of output frequency depends on the type of output waveform.
you change the type of output waveform, it might change the output frequency
If
because changing waveform types impacts on the setting range of output
frequency. The resolution is 1 μHz or 12 digits. For more information, refer to
the
AFG1000 Series Specifications and Performance Verification Technical
CW|FIXed means that the frequency is controlled by the
[SOURce[1|2]]:FREQuency[:CW|:FIXed] command. The sweep
is
invalid.
SWEep means that the output frequency is controlled by the sweep command
set. The sweep is valid.
38
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
Returns
CW|FIXed|SWEep
Examples
[SOURce[1|2]]:FREQuency:SPAN
Conditions
Group
SOURce1:FREQuency:MODE SWEep specifies the sweep command set for
controlling the CH 1 output frequency.
This command sets or queries the span of frequency sweep for the specified channel.
This command is always used with the [SOURce[1|2]]:FREQuency:CENTer
command. The setting range of frequency span depends on the waveform
selected
For the AFG1022, use
not apply to CH2 for the AFG1022.
AFG1000 Series Arbitrary Function Generator Programmer Manual
39
Command Descriptions
[SOURce[1|2]]:FREQuency:STARt
This command sets or queries the start frequency of sweep for the specified
channel. This command is always used with the
[SOURce[1|2]]:FREQuency:STOP
frequency depends on the waveform selected
refer to the AFG1000 Series
This command sets or queries the stop frequency of sweep for the specified
channel. This command is always used with the
[SOURce[1|2]]:FREQuency:STARt
frequency depends on the waveform selected
refer to the AFG1000 Series
command. The setting range of stop
for sweep. For more information,
Specifications and Performance Verification
40
AFG1000 Series Arbitrary Function Generator Programmer Manual
AFG1000 Series Arbitrary Function Generator Programmer Manual
41
Command Descriptions
Arguments
<frequency>::=<NRf>[<units>]
where:
<NRf> is the hop frequency.
<units>::=[Hz | kHz | MHz]
Returns
<frequency>
Examples
SOURce1:FSKey:FREQuency 1.0MHz
sets the hop frequency of CH 1 FSK modulation to 1.0 MHz.
[SOURce[1|2]]:FSKey:INTernal:RATE
This command sets or queries the internal modulation rate of FSK modulation
for the specified channel. Use this command when the internal modulation
source is selected.
Conditions
For the AFG1022, use
not apply to CH2 for the AFG1022.
INTernal means that the carrier waveform is modulated with an internal source.
EXTernal means that the carrier waveform is modulated with an external source.
Returns
Examples
INT|EXT
SOURce1:FSKey:SOURce INTernal
sets the CH 1 source of modulating signal to internal.
[SOURce[1|2]]:FSKey:STATe
This command enables or disables FSK modulation. The query returns the state
of FSK modulation. Select a sine, square, ramp, or arbitrary
carrier waveform.
Conditions
Group
Syntax
For the AFG1022, use
not apply to CH2 for the AFG1022.
Source
[SOURce[1|2]]:FSKey:STATe {ON|OFF|<NR1>}
[SOURce1]
waveform as the
. Modulation, sweep, and burst conditions do
AFG1000 Series Arbitrary Function Generator Programmer Manual
43
Command Descriptions
[SOURce[1|2]]:FSKey:STATe?
Arguments
Returns
ON or <NR1>≠0 enables FSK modulation.
OFF or <NR1>=0 disables FSK modulation.
<NR1>
Examples
SOURce1:FSKey:STATe ON
enables the CH 1 FSK modulation.
[SOURce[1|2]]:FUNCtion:EFILe
This command sets or queries an EFILe name used as an output waveform. A file
name must be specified in the mass storage system. This command returns “ ” if
there is no file in the mass storage.
<file_name>::=<string> specifies a file name in the mass storage system. The
<file_name> includes path. Path separators are forward slashes (/).
NOTE: The <file_name> argument is case sensitive.
<file_name>
Examples
SOURce1:FUNCtion:EFILe “SAMPLE1”
sets a file named “SAMPLE1” in the mass storage.
[SOURce[1|2]]:FUNCtion[:SHAPe]
This command sets or queries the shape of the output waveform. When the
specified user memory is deleted, this command causes an error if you select the
user memory.
44
AFG1000 Series Arbitrary Function Generator Programmer Manual
NOTE: The arguments defined in <Built_in> can not be abbreviated, all the
upper and lower case letters are needed.
The following table shows the combination of modulation type and the shape of
output waveform.
For AFG1022
Sine, Square, Ramp
AM
FM
PM
FSK
Sweep
Burst
For AFG1062
AM
FM
PM
PWM
√
√
√
√
√
√
Sine, Square, Ramp
√
√
√
√
Pulse
√
Pulse
Noise
Noise
Arb
√
√
√
√
√
√
Arb
√
√
√
FSK
ASK
PSK √
√
√
√
√
√
AFG1000 Series Arbitrary Function Generator Programmer Manual
45
Command Descriptions
Returns
Examples
Sweep
Burst
If you specify EFILe when there is no EFILe or the EFILe is not yet defined,
this command causes an error.
If you change the type of output waveform, it might change the output frequency
because changing waveform types impacts the setting range of output frequency.
USER<NR1>
<NR1> specifies the user waveform memory location.
For the AFG1022, <NR1> can be any number from 0 to 255.
For the AFG1062, <NR1> can be any number from 0 to 31.
A user defined waveform saved
EMEMory can be selected as an output
EFILe
EFILe is specified as an output waveform.
SIN|SQU|PULS|RAMP|PRN|
SOURce1:FUNCtion:SHAPe SQUare
√
√
|EMEMory
√
√
√
in the user waveform memory or the
waveform.
<Built_in>
|USER<NR1>|EMEMory|EFILe
selects the shape of CH 1 output waveform to square waveform.
[SOURce[1|2]]:PHASe[:ADJust]
This command sets or queries the phase of output waveform for the specified
channel. Set the value in radians or degrees. If no units are specified, the default
is RAD. The query returns the value in RAD.
This command is supported when you select a waveform other than DC and
Noise.
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
where:
<NR3> is the phase of output waveform.
<units>::=[RAD | DEG]
If <units> are omitted, RAD is specified automatically. The setting ranges are:
RAD: 0 to +2 PI, relative to phase value
DEG: 0 to +360, relative to phase value
Returns
<phase>
Examples
SOURce1:PHASe:ADJust MAXimum
sets the maximum value for the phase of CH 1 output waveform.
[SOURce[1|2]]:PHASe:INITiate (No Query Form)
This command synchronizes the phase of CH 1 and CH 2 output waveforms. The
arbitrary/function generator performs the same operation if you specify either
SOURce1 or SOURce2.
Group
Source
Syntax
Arguments
Examples
[SOURce[1|2]]:PHASe:INITiate
None
SOURce1:PHASe:INITiate
[SOURce[1|2]]:PM[:DEViation]
Conditions
synchronizes the phase of CH 1 and CH 2 output signals.
This command sets or queries the peak frequency deviation of PM modulation for
the specified channel.
For the AFG1022, use
not apply to CH2 for the AFG1022.
[SOURce1]
. Modulation, sweep, and burst conditions do
AFG1000 Series Arbitrary Function Generator Programmer Manual
If <units> are omitted, RAD is specified automatically. The setting ranges are:
RAD: 0 PI to +1 PI, relative to phase value
DEG: 0 to +180, in 1 degree steps, relative to phase value
<deviation>
SOURce1:PM:DEViation MAXimum
sets the maximum value for the CH 1 phase deviation.
[SOURce[1|2]]:PM:INTernal:FREQuency
This command sets or queries the internal modulation frequency of PM
modulation for the specified channel. Use this command when the internal
modulation source is selected.
Set the internal modulation frequency from 2 mHz to 20.00 kHz with
of 1 mHz.
Conditions
Group
Syntax
For the AFG1022, use
not apply to CH2 for the AFG1022.
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
Arguments
<frequency>::=<NRf>[<units>]
where:
<NRf> is the modulation frequency.
<units>::=[Hz | kHz | MHz]
Returns
<frequency>
Examples
SOURce1:PM:INTernal:FREQuency 10kHz
sets the CH 1 internal modulation frequency to 10 kHz.
[SOURce[1|2]]:PM:INTernal:FUNCtion
This command sets or queries the modulating waveform of PM modulation for the
specified channel. Use this command when the internal modulation source is
selected.
If you specify EFILe when there is no EFILe or the EFILe is not yet defined,
this command causes an error.
<NR1> specifies the user waveform memory location.
For the AFG1022, <NR1> can be any number from 0 to 255.
For the AFG1062, <NR1> can be any number from 0 to 31.
A user defined waveform saved in the user waveform memory or the
EMEMory
EFILe
|EMEMory
can be selected as a modulating signal.
AFG1000 Series Arbitrary Function Generator Programmer Manual
49
Command Descriptions
EFILe
is used as a modulating signal.
Returns
Examples
SIN|SQU|RAMP|PRN|USER<NR1>|EMEMory|EFILe
SOURce1:PM:INTernal:FUNCtion SQUare
selects Square as the shape of modulating waveform for the CH 1 output.
[SOURce[1|2]]:PM:INTernal:FUNCtion:EFILe
This command sets or queries an EFILe name used as a modulating waveform for
PM modulation. A file name must be specified in the mass storage system. This
command returns “ ” if there is no file in the mass storage.
Conditions
For the AFG1022, use
not apply to CH2 for the AFG1022.
INTernal means that the carrier waveform is modulated with an internal source.
EXTernal means that the carrier waveform is modulated with an external source.
INT|EXT
SOURce1:PM:SOURce INTernal
sets the CH 1 source of modulating signal to internal.
This command enables or disables PM modulation. The query returns the state
of PM modulation. Select a sine, square, ramp, or arbitrary
carrier waveform.
For the AFG1022, use
not apply to CH2 for the AFG1022.
If <units> are omitted, RAD is specified automatically. The setting ranges are:
RAD: 0 PI to +1 PI, relative to phase value
DEG: 0 to +180, in 1 degree steps, relative to phase value
<deviation>
SOURce1:PSKey:DEViation MAXimum
sets the maximum value for the CH 1 phase deviation.
[SOURce[1|2]]:PSKey:INTernal:RATE
This command sets or queries the internal modulation rate of PSK modulation
for the specified channel. Use this command when the internal modulation
source is selected.
52
AFG1000 Series Arbitrary Function Generator Programmer Manual
INTernal means that the carrier waveform is modulated with an internal source.
EXTernal means that the carrier waveform is modulated with an external source.
INT|EXT
AFG1000 Series Arbitrary Function Generator Programmer Manual
53
Command Descriptions
Examples
SOURce1:PSKey:SOURce INTernal
sets the CH 1 source of modulating signal to internal.
[SOURce[1|2]]:PSKey:STATe
This command enables or disables PSK modulation. The query returns the state
of PSK modulation. Select a sine, square, ramp, or arbitrary
carrier waveform.
sets the duty cycle of the pulse waveform on CH 1 to 80.5%.
[SOURce[1|2]]:PWM:INTernal:FREQuency
This command sets or queries the internal modulation frequency of PWM
modulation for the specified channel. Use this command when the internal
modulation source is selected.
[MINimum|MAXimum]
Set the internal modulation frequency from 2 mHz to 20.00 kHz with
resolution
of 1 mHz.
Select the source of modulating signal by using the
[SOURce[1|2]]:PWM:SOURce [INTernal|EXTernal] command.
Conditions
AFG1062 only
Group
Source
Syntax
[SOURce[1|2]]:PWM:INTernal:FREQuency
{<frequency>|MINimum|MAXimum}
[SOURce[1|2]]:PWM:INTernal:FREQuency?
Related Commands
[SOURce[1|2]]:PWM:SOURce
AFG1000 Series Arbitrary Function Generator Programmer Manual
55
Command Descriptions
Arguments
<frequency>::=<NRf>[<units>]
where <NRf> is the modulation frequency.
<units>::=[Hz | kHz | MHz]
Returns
<frequency>
Examples
SOURce1:PWM:INTernal:FREQuency 10kHz
sets the CH 1 internal frequency to 10 kHz.
[SOURce[1|2]]:PWM:INTernal:FUNCtion
This command sets or queries the modulating waveform of PWM modulation
for the specified channel. Use this command when the internal modulation
source is selected.
If you specify EFILe when there is no EFILe or the EFILe is not yet defined,
this command causes an error.
One of four types of function waveform can be selected as a modulating signal.
USER<NR1>|EMEMory
<NR1> specifies the user waveform memory location.
For the AFG1022, <NR1> can be any number from 0 to 255.
For the AFG1062, <NR1> can be any number from 0 to 31.
56
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
A user defined waveform saved in the user waveform memory or the
EMEMory
EFILe
can be selected as a modulating signal.
EFILe is used as a modulating signal.
Returns
SIN|SQU|RAMP|PRN|USER<NR1>|EMEMory|EFILe
Examples
SOURce1:PWM:INTernal:FUNCtion SQUare
selects Square as the shape of modulating waveform for the CH 1 output.
[SOURce[1|2]]:PWM:INTernal:FUNCtion:EFILe
This command sets or queries an EFILe name used as a modulating waveform
for
PWM modulation. A file name must be specified in the mass storage system.
This
command returns “ ” if there is no file in the mass storage.
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
Arguments
Returns
Examples
LINear sets the sweep spacing to linear.
LOGarithmic sets the sweep spacing to logarithmic.
LIN|LOG
SOURce1:SWEep:SPACing LINear
sets the CH1 sweep spacing to linear.
[SOURce[1|2]]:SWEep:TIME
Conditions
Group
Syntax
Arguments
Returns
Examples
This command sets or queries the sweep time for the sweep for the specified
channel. The sweep time does not include hold time and return time. The setting
range is 1 ms to 500 s.
For the AFG1022, use
not apply to CH2 for the AFG1022.
<NR1> specifies the user waveform memory location.
For the AFG1022, <NR1> can be any number from 0 to 255.
For the AFG1062, <NR1> can be any number from 0 to 31.
DATA:COPY USER0,EMEMory
copies the waveform data in the edit memory to the user waveform memory
64
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
USER0.
TRACe|DATA[:DATA]
Group
Syntax
Arguments
DATA:COPY EMEMory,USER0
copies the waveform data in the user waveform memory USER0 to the edit
memory.
This command transfers the waveform data from the external controller to the
edit
memory in the instrument. The query returns the binary block data.
<binary_block_data>
where <binary_block_data> is the waveform data in binary
EMEMory
format.
Returns
Examples
<binary_block_data>
DATA:DATA EMEMory,#42000<DAB><DAB>...<DAB>
transmits a waveform to the edit memory in the instrument. The block data
element #42000 indicates that 4 is the number of digits in 2000 (byte count) and
the 2000 bytes of binary data are to be transmitted.
TRACe|DATA[:DATA]:VALue
This command sets or queries the data value at the specified point in the edit
memory.
<NR1> sets the number of points for the waveform created in the edit
memory.
For the AFG1022, <NR1> can be any number from 2 to 8192.
For the AFG1062, <NR1> can be any number from 2 to 1048576.
Returns
<NR1>
66
AFG1000 Series Arbitrary Function Generator Programmer Manual
Command Descriptions
Examples
*TRG (No Query Form)
Group
Syntax
Arguments
Examples
*WAI (No Query Form)
DATA:POINts EMEMory, 500
sets the waveform data points to 500 in the edit memory.
This command generates a trigger event.
Trigger
*TRG
None
*TRG
generates a trigger event.
This command prevents the instrument from executing further commands or
queries until all pending commands that generate an OPC message are complete.
Group
Synchronization
*WAI
Syntax
Arguments
Examples
None
*WAI
prevents the instrument from executing any further commands or queries until all
pending commands that generate an OPC message are complete.
AFG1000 Series Arbitrary Function Generator Programmer Manual
67
Command Errors
The following table shows the error messages generated by improper command
syntax. Check that the command is properly formed and that it follows the rules
in the Syntax and Commands.
Table 15: Command messages
Code Message
0 (indicates no error)
-101 Invalid character
-102 Syntax error
-108 Parameter not allowed
-201 Invalid while in local
Error/Event Queue
The event queue is an FIFO queue, which stores events as they occur in the
instrument. The event queue can store up to 64 events.
The oldest error code and text are retrieved by using the following command:
SYSTem:ERRor[:NEXT]?
68
AFG1000 Series Arbitrary Function Generator Programmer Manual