Tektronix AFG3102C, AFG3051C, AFG3251C, AFG3252C, AFG3101 Programmer Manual

...

Download

AFG3000 Series

ZZZ

Arbitrary Function Generators

Programmer Manual

*P077074302*

077-0743-02

AFG3000 Series

ZZZ

Arbitrary Function Generators

Programmer Manual

www.tektronix.com

077-0743-02

Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions.

Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in all previously published material. Speciﬁca tions and price change privileges reserved.

TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.

Contacting

Tektronix, Inc. 14150 SW Karl Braun Drive P.O . Bo x 50 Beaverton, OR 97077 USA

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

In North America, call 1-800-833-9200. World w i

Tektronix

de, visit www.tektronix.com to ﬁnd 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. Batteries a warranty work may be new or reconditioned to like new performance. All replaced 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 o f 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 other charges for products returned to any other locations.

re excluded from this warranty. Parts, modules and replacement products used by Tektronix for

center is located. Customer shall be responsible for paying all shipping charges, duties, taxes, and any

This wa 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 incompatible equipment; c) to repair any damage or malfunction caused by the use of non-Tektronix supplies; or d) to service a product that has been modiﬁed or integrated with other products when the effect of such modiﬁcation or integration incr

THIS WARRANTY IS GIVEN BY TEKTRONIX WITH RESPECT TO THE PRODUCT IN LIEU OF ANY OTH IMPLIED WARRANTIES OF MER CHA NTABILITY 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 T

[W16 – 15AUG04]

rranty shall not apply to any defect, failure or damage caused by improper use or improper or

eases the time or difﬁculty of servicing the product.

ER WARRANTIES, EXPRESS OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY

HE VENDOR HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.

Table of Contents

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

Documentation................................................................................................ iii

Getting Started

Getting Started . ... . ... ... ... . ... ... . ... ... ... . ... ... . .. . ... ... . ... ... ... . ... ... . ... ... ... . ... ... . .. . ... ... . ... ... . 1-1

Overview of the Manual ... ................................ .................................. ............... 1-1

Connecting the Interface .................................................................................... 1-2

Using the GPIB Port............................ ................................ ............................. 1-3

Setting the GPIB Address.. . ... ... . ... ... . ... ... . .. . ... . . .. . ... . . .. . ... . . .. . ... . . .. . ... . . .. . ... ... . ... ... . .. 1-4

Using TekVISA .............................................................................................. 1-4

Syntax and Commands

Syntax and Commands........................................................................................... 2-1

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

Backus-Naur Form Deﬁnition . . ... ... . ... ... ... . ... ... . . .. . ... ... . .. . ... ... . .. . ... ... . ... ... ... . ... ... . . .. . 2-2

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

SCPI Commands and Queries .............................................................................. 2-4

IEEE 488.2 Common Commands............................. .................................. ........... 2-9

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

Command Descriptions ........................................................................................ 2-19

Status and Events

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

Status Reporting Structure .................................................................................. 3-1

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

Queues ...................................................................................................... 3-12

Messages and Codes........................ .................................. ............................. 3-12

Programming Examples

Programming Examples ............................ .................................. ........................... 4-1

Appendices

Appendix A: SCPI Conformance Information . .................................. ............................ A-1

Appendix B: EMEMory detailed description..................................... ............................ B-1

AFG3000 Series Arbitrary Function Generator Programmer Manual i

Table of Contents

ii AFG3000 Series Arbitrary Function Generator Programmer Manual

Preface

This manual provides operating information for the following products:

Table i: Supported products

AFG3011 AFG3021B AFG3011C

AFG3101 AFG3022B AFG3021C

AFG3102 AFG3022C

AFG3251 AFG3051C

AFG3252 AFG3052C

AFG3101C

AFG3102C

AFG3151C

AFG3152C

AFG3251C

AFG3252C

The manual consists of the following sections:

Getting Started covers operating principles of the instrument, which helps you understand how your generator operates.

Documentation

Syntax and Commands deﬁnes the command syntax and processing conventions, describes command notation.

Status and Events explains the status information and event messages reported by the instrument.

Programming Examples contains remote interface application programs to help you develop programs for your application.

Appendix A: SCPI Conformance Information contains a list of commands and SCPI information.

The following table lists related documentation available for your instrument. The documentation is available on the Document CD and on the Tektronix Web site (www.tektronix.com/downloads).

AFG3000 Series Arbitrary Function Generator Programmer Manual iii

Preface

Item Purpose Location

Compliance an Safety Instructions

User Manual Unpacking,

Programmer Manual (this document)

Service Manual Self-service and

Compliance, s introduction to UI, basic turn on/off

Installation, Tutorials, Operation, and Overviews available in English, German, French, Italian, Portuguese, Spanish, Korean, Russian, Japanese, Simpliﬁed Chinese, and Traditional Chinese

Menu structures, user interface, and programming commands

performance test

afety,

Technical Reference

ArbExpress AXW100 Software and use documents

Speciﬁcations and perf veriﬁcation procedures

Waveform creation

Import from oscilloscope or PC

ormance

waveforms

iv AFG3000 Series Arbitrary Function Generator Programmer Manual

Getting Started

Overview of the Manual

To help you get started with programming the arbitrary function generator, this section includes the following subsections

Overview of the Manual

Summarizes each major section of this manual.

Connecting the Interface

Describes how to physically connect the arbitrary function generator to a controlle

Using the GPIB Port

Describe

Setting the GPIB Address

Describ

Using TekVISA

Descri

The in

s how to use the GPIB port.

es how to set the GPIB parameters from the front panel.

bes how to use the TekVISA communication protocol.

formation contained in each major section of this manual is described below.

Syntax and Commands

Syntax and Commands, describes the structure and content of the messages your program sends to the arbitrary function generator. The following ﬁgure shows

mand parts as described in the Command Syntax subsection.

com

gure 1-1: Command parts

AFG3000 Series Arbitrary Function Generator Programmer Manual 1-1

Getting Star ted

Section 2 also d of how you might use it. The Command Groups subsection provides lists by functional areas. The commands are listed alphabetically in the Command Descriptions section.

Figure 1-2: Functional groupings and an alphabetical list of commands

Status and Even ts

The program may request information from the instrument. The instrument provides information in the form of status and error messages. The following ﬁgure illustrates the basic operation of this system. Section 3, Status and Events, describes how to get status or event information from the program and details the event and error messages.

escribes the effect of each command and provides examples

Connecting the Interface

The instrument has a 24-pin GPIB connector on its rear panel, as shown in the following ﬁgure. This connector has a D-type shell and conforms to IEEE Std

488.1-1987. Attach an IEEE Std 488.1-1987 GPIB cable (Tektronix part number 012-0991-00) to this connector.

1-2 AFG3000 Series Arbitrary Function Generator Programmer Manual

Getting Started

Using the GPIB Port

Figure 1-3:

The arbitrary function generator has Talk/Listen functions through which it can communicate with other devices, as well as the external controller, located on the bus.

Figure 1-4: GPIB connection

GPIB connector (rear panel)

rve the following rules when you use your arbitrary function generator with

GPIB Requirements

AFG3000 Series Arbitrary Function Generator Programmer Manual 1-3

Obse aGPIBnetwork

ign a unique device address to each device on the bus. No two devices

Ass cansharethesamedeviceaddress.

not connect more than 15 devices to any one bus.

Connect one device for every 2 m (6 ft) of cable used.

Do not use more than 20 m (65 ft) of cable to connect devices to a bus.

Turn on at least 2/3 of the devices on the network while using the network.

Connect the devices on the network in a star or linear conﬁguration, as shown in the following ﬁgure. Do not use loop or parallel conﬁgurations.

Getting Star ted

Figure 1-5: Typical GPIB network conﬁgurations

Setting the GPIB Address

When you use the GPIB port to comm unicate with an external controller, follow these steps to set the address of the arbitrary function generator.

1. Press the Utility button.

2. Press the I/O Interface button.

Using TekVISA

3. Press the GPIB button.

4. Press the Address button.

5. Turn the general purpose knob to set the GPIB Address. The GPIB address

must be from 0 to 30.

6. Press the Return to top menu button when you have set the GPIB address to save the setting.

7. Press the Conﬁguration button to toggle the instrument communications to Talk/Listen to remotely control the instrument from an e xternal host computer.

NOTE. The GPIB address cannot be initialized by the *RST command.

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. You can 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 speciﬁcation for controlling GPIB and serial (RS-232) instrument interfaces locally or remotely via an Ethernet LAN connection.

1-4 AFG3000 Series Arbitrary Function Generator Programmer Manual

Getting Started

Installation

Use an internet (www.tektronix.com/downloads) and download the current TekVISA to your PC. Unzip the downloaded ﬁle in a temporary directory of your choice and run Setup.exe.

NOTE. The details on TekVISA concepts and operations are explained in the

TekVISA Programmer M anual that can be also found on the Tektronix Web site.

browser to access the Tektronix Web site

AFG3000 Series Arbitrary Function Generator Programmer Manual 1-5

Getting Star ted

1-6 AFG3000 Series Arbitrary Function Generator Programmer Manual

Syntax and Commands

This section provides the following information:

Command Syntax deﬁnes the command syntax and processing conventions.

Command Groups describes command groups which lists the commands

by function.

Command Descriptions describes the notation of each of the commands in alphabetical order.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-1

Command Syntax

Command Synta

You ca n c ont r through the GPIB 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 instrument u se s to process them. See Command Groups ((See page 2-11.)) for a listing of the commands by command group, or use the index to locate a speciﬁc command.

Backus-Naur Form Deﬁnition

This manual may describe commands and queries using the Backus-Naur Form (BNF) notation. The following table deﬁnes the standard BNF symbols.

Table 2-1: BNF symbols and meanings

Symbol

| Exclusive OR

{ } Group; one element is required

[] .. .

( ) Comment

ol the operations and functions of the arbitrary function generator

Meaning

Deﬁned element

Is deﬁned as

Optional; can be omitted

Previous element(s) may be repeated

Command and Query Structure

Commands consist of set commands and query commands (usually simply called commands and queries). Commands change instrument settings or perform a speciﬁc action. Queries cause the instrum enttoreturndataandinformationabout its status.

Most commands have both a set form a nd a query form. The query form of the command is the same as the set form except that it ends with a question mark. For example, the set command

DISPlay:CONTrast?. Not all commands have both a set and a query form;

some commands are set only and some are query only.

A few commands do both a set and query a ction. For example, the command runs a self-calibration program on the instrument, then returns the result of the calibration.

A command message is a command or query name, followed by any information the instrument needs to execute the command or que ry. Command messa ges consist of ﬁve element types.

DISPlay:CONTrast h as a query form

*CAL?

2-2 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Syntax

Table 2-2: Comm

Symbol Meaning

<Argument

<Comma> A single c

<Space>

and message elements

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 colon is required. The beginning colon can never be used with command 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.

A quantity all commands have an argument, while other commands have multiple arguments. Arguments are separated from the header by a Arguments are separa

may optionally have white space characters before and after the comma.

Awhites optionally consist of multiple white space characters.

d is concatenated with other commands the beginning

header has multiple mnemonics, they are always separated

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

ted from each other by a <Comma>.

omma between arguments of multiple-argument commands. It

pace character between command header and argument. It may

The following ﬁgure shows the ﬁve command message elements.

Commands. Commands cause the instrument to perform a speciﬁc function or change one of its settings. Commands have the structure:

[:]<Header>[<Space><Argument>[<C omm a>< Arg ume nt> ].. .]

mmand header is made up of one or more mnemonics arranged in a

Aco hierarchical or tree structure. The ﬁrst 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 m ay affect those at a lower level. The leading colon (:) always returns you to the base of the command tree.

ueries. Queries cause the arbitrary function generator to return information

about its status or settings. Queries have the structure:

[:]<Header>?

[:]<Header>?[<Space><Argument>[< Com ma> <Ar gume nt> ].. .]

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-3

Command Syntax

Command Entry

You can specify otherwise noted. These branch queries return information about all the mnemonics below the speciﬁed branch or level.

Query Responses. When a query is sent to the arbitrary function generator, only the values are returned. When the returned value is a mnemonic, it is noted in abbreviated format, as shown in the following table.(See Table 2-3.).

Table 2-3: Query response examples

Symbol Meaning

SOURce:PULSe:DCYcle?

OUTPut:POLarity? NORM

Follow these general rules when entering commands:

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 t

The instrument ignores commands that consists o f just a combination of white space characters and line feed

a query command at any level within the command tree unless

50.0

hrough 32 decimal).

SCPI Commands and Queries

The arbitrary function generator 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 consist environment for instrument control and data transfer. This environment uses deﬁned programming messages, instrument responses and data formats that operate across all SCPI instruments, regardless of manufacturer.

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

Figure 2-1: Example of SCPI subsystem hierarchy tree

ent programming

2-4 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Syntax

Creating Commands

Parameter Types

You can create c Commands specify actions for the instrument to perform. Queries return measurement data and information about parameter settings.

SCPI command hierarchy and separating each node by a colon.

In the ﬁgure SOURce are lower-level nodes. To create a SCPI command, sta rt with the root node TRIGger and move down the tree structure adding nodes until you reach the end of a branch. Most commands and some queries have parameters; you must include a value for these parameters. If you specify a parameter value that is out of range, the parameter will be set to a default value. The command descriptions, list the

For example, TRIGgerEVENt:SOURce EXTRear is a valid SCPI command created

Parameters are indicated by angle brackets, such as <ﬁle_name>.There are several different types of parameters. (See Table 2-4.) The parameter type is listed after the pa function generator command set and some are deﬁned by SCPI.

valid values for all parameters.

from the hierarchy tree. (See Figure 2-1.)

rameter. Some parameter types are deﬁned speciﬁcally for the arbitrary/

ommands and queries from these subsystem hierarchy trees.

s are created by stringing together the nodes of a subsystem

above, TRIGger is the root node and EVENt, GATed, INPut, and

Creating Queries

Query Responses

Parameter Types

To create a que ry, start at the root node of a tree structure, move down to the end

branch, and add a question mark. TRIGgerEVENt:SOURce? is an example

of a of a valid SCPI query using the hierarchy tree in the ﬁgure. (SeeFigure2-1.)

The query causes the arbitrary function generator to return information about its

atus or settings. When a query is sent to the arbitrary function generator, only

st the values a re returned. When the returned value is a mnemonic, it is noted in abbreviated format, as shown in the following table.

Every parameter in the command and query descriptions is of a speciﬁed type. The parameters are enclosed in brackets, such as <value>. The parameter type is listed after the p arameter and is e nclosed in parentheses, for example, (boolean). Some parameter types are deﬁned speciﬁcally for the arbitrary function generator command set and some are deﬁnedbySCPI.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-5

Command Syntax

Table 2-4: Para

Parameter typ

arbitrary block

meter types used in syntax descriptions

Description Example

A speciﬁed len

gth of

arbitrary data

#512234xxxxx

...where 5 indicates that the following 5 digits (12234) specify the length of the

data in bytes; xxxxx ... indicates the data or

#0xxxxx...<LF><&EOI>

boolean Boolean num

bers or values

ON or ≠ 0

OFF or 0

discrete

a LIST OF SPECIFIC VALUES

binary Binary numbers

octal

hexadecimal

Octal numbers #Q57, #Q3

Hexadecimal numbers

min, max

#B0110

#HAA, #H1

(0-9,A,B,C,D,E,F)

NR12numeric Integers 0, 1, 15, -1

NR223n

umeric

Decima

l numbers

1.2, 3.

141516, -6.5

NR32numeric Floating point numbers 3.1415E-9, -16.1E5

NRf2numeric

string

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

anumeric characters (must

Alph

See NR1, NR2, and NR3

les

examp

"Testing 1, 2, 3"

be within quotation marks)

Deﬁned in ANSI/IEEE 488.2 as "Deﬁnite Length Arbitrary Block Response Data."

SI/IEEE 488.2-1992-deﬁned parameter type.

An AN

Some commands and queries will accept an octal or hexadecimal value even though the parameter type is deﬁned as NR1.

Deﬁned in ANSI/IEEE 488.2 as "String Response Data."

Special Characters

The Line Feed (LF) character (ASCII 10), and all characters in the range of ASCII 127-255 are deﬁned as special characters. These characters are used in arbitrary block arguments only; using these characters in other parts of any command yields unpredictable results.

Abbreviating Commands,

Queries, and Parameters

You can abbreviate most SCPI com mands, queries, and parameters to an accepted short form. This manual shows these short forms as a combination of upper and lower case letters. The upper case letters indicate the accepted short form of a command. As shown in the following ﬁgure, you can 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 instrum ent.

2-6 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Syntax

Chainin

g Commands and

Queries

Figure 2-2:

NOTE. The numeric sufﬁx of a command or query may be included in either the

long form or short form; the arbitrary function generator will default to "1" if no sufﬁxisused.

You can chain several commands or queries together into a single message. To create a chained message, ﬁrst create a command or query, add a semicolon (;), and then add more commands or queries and semicolons until the message is comp with a colon (:). The following ﬁgure illustrates a chained message consisting of several commands and queries. The single chained message should end in a command or query, not a semicolon. Responses to any queries in your message are separated by semicolons.

Example of abbreviating a command

lete. If the command following a semicolon is a root node, precede it

gure 2-3: Example of chaining commands and queries

f a command o r query has the same root and lower-level nodes a s the previous

I command or query, you can omit these nodes. In the following ﬁgure, the second command has the same root node (TRIGger:SEQuence) as the ﬁrst command, so these nodes can be omitted.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-7

Command Syntax

Figure 2-4: Example of omitting root and lower-level nodes in a chained message

Unit and SI Preﬁx

If the decimal numeric argument refers to amplitude, frequency, or time, you can express it using SI units instead o f using the scaled explicit point input value format <NR3>. (SI units are units that conform to the Systeme International d'Unites standard.) For example, you can 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.

The following table lists the available units.

Table 2-5: Available units

Symbol

dBm

DEG degree (phase)

PCT percent (%) s

Vvolt

Meaning

decibel (relative amplitude)

decibel (absolute amplitude)

hertz (frequency)

second (time)

TheavailableSIpreﬁxes are shown in the following table.

Table 2-6: Available SI preﬁxes

GT PEEX

+12

SI preﬁxZAFPNUMKMA

-21

Corresponding power

When the unit is "Hz", "M" may be used instead of "MA" so that the frequency can be represented by "MHz".

-18

-15

-12

-9

-6

-3

+15

+18

You can omit a unit in a command, but you must include the unit when using a SI preﬁx. For e xample, frequency of 15 MHz c an be described as follows

15.0E6, 1.5E7Hz, 15000000, 15000000Hz, 15MHz, etc. ("15M" is not allowed.)

Note that you can use either lower or upper case units and preﬁxes. The following examples have the same result, respectively.

2-8 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Syntax

General rules for using

SCPI commands

170mHz, 170mHz 250mv, 250mV, 250MV, etc.

Here are three general rules for using SCPI commands, queries, and parameters:

You can use single (‘ ’) or double (“ ”) quotation marks for quoted strings, but you cannot use both types of quotation marks for the same string.

correct "This string uses quotation marks correctly."

correct ‘This string also uses quotation marks correctly.'

incorrect "This string does not use quotation marks correctly.'

You can use upper case, lower case, or a mixture of both cases for all commands, queries, and parameters.

:SOURCE:FREQUENCY 10MHZ

is the same as

:source:frequency 100mhz

and

SOURCE:frequency 10MHZ

, 170MHz, etc.

NOTE. Literal strings (quoted) are case sensitive, for example, ﬁle names.

No embedded spaces are allowed between or within nodes.

correct

incorrect :OUTPUT: FILTE R: LPASS:FREQUE NCY 200MHZ

IEEE 488.2 Common Commands

Description

Command and Query

Structure

ANSI/IEEE Standard 488.2 deﬁnes the codes, formats, protocols, common commands and queries used on the interface between the controller and the instruments. The arbitrary function generator 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.2commonqueryisanasterisk(*)followedbyaqueryandaquestionmark. All of the common commands and queries are listed in the last part of the Syntax and Commands section. The following are examples of common commands:

*ESE 1 6

:OUTPUT:FILTER:LPASS:FREQUENCY 200MHZ

and usage of

*CLS

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-9

Command Syntax

The following a

*ESR

*IDN

re examples of common queries:

2-10 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Groups

This section lists the commands organized by functional group. The Command Descriptions section lists all commands alphabetically.

Calibration and Diagnostic Commands. Calibration and Diagnostic commands let you initiate the instrument self-calibration routines and examine the results of diagnostic tests. lists Calibration and Diagnostic commands.

Table 2-7: Calibration and Diagnostic commands

Header Description

*CAL? Perform self-calibration and return result

CALibration[:ALL] Perform self-calibration

DIAGnostic[:ALL] Perform self-test

*TST? Perform self-test and return result status

status

Display Commands. Dis

play commands let you change the graticule style, displayed contrast, and other display attributes. The following table lists and describes Display commands.

Table 2-8: Display commands

Header Description

DISPlay:CONTrast Set/query the LCD display contrast

DISPlay:SAVer:IMMediate Set screen saver

DISPlay:SAVer[:STATe] Set/query the screen saver settings

DISPlay[:WINDow]:TEXT[:DATA] Set/query the text message display

DISPlay[:WINDow]:TEXT:CLEar

Delete text message

Memory Commands. Memory commands let you change setup memory attributes. The following table lists and describes Memory commands.

Table 2-9: Memory commands

Header Description

MEMory:STATe:DELete

MEMory:STATe:LOCK Set/query the lock of setup memory overwrite

MEMory:STATe:RECall:AUTo Set/query the recall of last set memory

MEMory:STATe:VALid? Query the availability of setup memory

*RCL Recall instrument setting from setup memory

*SAV Save instrument setting to setup memory

Delete the setup memory

and deletion

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-11

Command Groups

Mass Memory Com

mands. Mass Memory commands let you change mass

memory attributes. The following table lists and describes Mass Memory commands.

Table 2-10: Mass Memory commands

Header Description

MMEMory:CATalog? Query the status of mass memory

MMEMory:CDIRectory Set/query current directory

MMEMory:DELete

MMEMory:LOAD:STATe Copy instrument setting in mass memory to

MMEMory:LOAD:TRACe Copy waveform data ﬁle in mass memory to

MMEMory:LOCK[:STATe] Set/query the lock of mass memory overwrite

MMEMory:MDIRectory

MMEMory:STORe:STATe Save the setup memory status to mass

MMEMory:STORe:TRACe Save waveform data ﬁle in edit memory to

Delete ﬁle or directory in mass memory

setup memory

edit memory

and deletion

Create directory in mass memory

memory

mass memory

Output Commands. Output commands let you set output attributes. The following table lists and describes Output commands.

ance

rity

Te]

MODE

mmands

Set/query impedanc

Set/query polarit

Set/query output o

Set/query the mod

noroff

e of Trigger Output

Table 2-11: Output co

Header Description

OUTPut[1|2]:IMPed

OUTPut[1|2]:POLa

OUTPut[1|2][:STA

OUTPut:TRIGger:

Source Commands. Source commands let you set waveform output parameters. The following table lists and describes Source commands.

Table 2-12: Source commands

Header Description

[SOURce]:ROSCillator:SOURce Set/query clock reference input

[SOURce[1|2]]:AM[:DEPTh] Set/query amplitude modulation depth

[SOURce[1|2]]:AM:INTernal:FREQuency Set/query internal modulation frequency

[SOURce[1|2]]:AM:INTernal:FUNCtion Set/query modulation waveform setting

[SOURce[1|2]]:AM:INTernal:FUNCtion: EFILe

Set/query EFILe setting

2-12 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Groups

Table 2-12: Source commands (cont.)

Header Description

[SOURce[1|2]]:AM:SOURce Set/query a mplitude modulation source

[SOURce[1|2]]:AM:STATe Set/query a mplitude modulation status

[SOURce[1|2]]:BURSt:MODE Set/query burst mode

[SOURce[1|2]]:BURSt:NCYCles Set/query burst mode waveform output cycle

[SOURce[1|2]]:BURSt[:STATe] Set/query burst mode status

[SOURce[1|2]]:BURSt:TDELay Set/query burst mode trigger delay time

[SOURce[1|2]]:COMBine:FEED Set/query internal noise or external signal

[SOURce[1|2]]:FM[:DEViation] Set/query frequency deviation

[SOURce[1|2]]:FM:INTernal:FREQuency Set/query internal modulation frequency

[SOURce[1|2]]:FM:INTernal:FUNCtion Set/query internal modulation waveform

[SOURce[1|2]]:FM:INTernal:FUNCtion:EFILe Set/query EFILe setting

[SOURce[1|2]]:FM:SOURce Set/query frequency modulation source

[SOURce[1|2]]:FM:STATe Set/query frequency modulation status

[SOURce[1|2]]:FREQuency:CENTer Set/query center frequency

[SOURce[1|2]]:FREQuency:CONCurrent[: STATe]

[SOURce[1|2]]:FREQuency[:CW|:FIXed] Set/query output waveform frequency

[SOURce[1|2]]:FREQuency:MODE Set/query sweep status

[SOURce[1|2]]:FREQuency:SPAN Set/query sweep frequency span

[SOURce[1|2]]:FREQuency:STARt Set/query sweep start frequency

[SOURce[1|2]]:FREQuency:STOP Set/query sweep stop frequency

[SOURce[1|2]]:FSKey[:FREQuency] Set/query FSK hop frequency

[SOURce[1|2]]:FSKey:INTernal:RATE Set/query FSK internal modulation rate

[SOURce[1|2]]:FSKey:SOURce Set/query FSK source

[SOURce[1|2]]:FSKey:STATe Set/query FSK status

[SOURce[1|2]]:FUNCtion:EFILe Set/query EFILe name

[SOURce[1|2]]:FUNCtion:RAMP:SYMMetry Set/query ramp waveform symmetry

[SOURce[1|2]]:FUNCtion[:SHAPe] Set/query output waveform

[SOURce[1|2]]:PHASe[:ADJust] Set/query output waveform phase

[SOURce[1|2]]:PHASe:INITiate Initiate output waveform phase

[SOURce[1|2]]:PM[:DEViation] Set/query phase modulation deviation

[SOURce[1|2]]:PM:INTernal:FREQuency Set/query internal modulation frequency

[SOURce[1|2]]:PM:INTernal:FUNCtion Set/query internal modulation waveform

[SOURce[1|2]]:PM:INTernal:FUNCtion: EFILe

[SOURce[1|2]]:PM:SOURce Set/query phase modulation source

Set/query concurrent change of frequency

synchronization

Set/query EFILe name

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-13

Command Groups

Table 2-12: Source commands (cont.)

Header Description

[SOURce[1|2]]:PM:STATe Set/query phase modulation status

[SOURce[1|2]]:PULSe:DCYCle Set/query pulse waveform duty cycle

[SOURce[1|2]]:PULSe:DELay Set/query pulse waveform lead delay

[SOURce[1|2]]:PULSe:HOLD Set/query pulse waveform parameter

[SOURce[1|2]]:PULSe:PERiod Set/query pulse waveform period

[SOURce[1|2]]:PULSe:TRANsition[: LEADing]

[SOURce[1|2]]:PULSe:TRANsition:TRAiling Set/query pulse waveform trailing edge time

[SOURce[1|2]]:PULSe:WIDTh Set/query pulse waveform width

[SOURce[1|2]]:PWM:INTernal:FREQuency Set/query pulse width modulation frequency

[SOURce[1|2]]:PWM:INTernal:FUNCtion Set/query pulse width modulation waveform

[SOURce[1|2]]:PWM:INTernal:FUNCtion: EFILe

[SOURce[1|2]]:PWM:SOURce Set/query pulse width modulation source

[SOURce[1|2]]:PWM:STATe Set/query pulse width modulation status

[SOURce[1|2]]:PWM[:DEViation]:DCYCle Set/query pulse width modulation deviation

[SOURce[1|2]]:SWEep:HTIMe Set/query sweep hold time

[SOURce[1|2]]:SWEep:MODE Set/query sweep mode

[SOURce[1|2]]:SWEep:RTIMe Set/query sweep return time

[SOURce[1|2]]:SWEep:SPACing Set/query sweep spacing

[SOURce[1|2]]:SWEep:TIME Set/query sweep time

[SOURce[1|2]]:VOLTage:CONCurrent[: STATe]

[SOURce[1|2]]:VOLTage:LIMit:HIGH Set/query output amplitude upper limit

[SOURce[1|2]]:VOLTage:LIMit:LOW Set/query output amplitude lower limit

[SOURce[1|2]]:VOLTage:UNIT Set/query output amplitude units

[SOURce[1|2]]:VOLTage[:LEVel][: IMMediate]:HIGH

[SOURce[1|2]]:VOLTage[:LEVel][: IMMediate]:LOW

[SOURce[1|2]]:VOLTage[:LEVel][: IMMediate]:OFFSet

[SOURce[1|2]]:VOLTage[:LEVel][: IMMediate][:AMPLitude]

SOURce<3|4>:POWer[:LEVel][:IMMediate][: AMPLitude]

Set/query pulse waveform leading edge time

Set/query EFILe name

Set/query concurrent change of amplitude level

Set/query output amplitude high level

Set/query output amplitude low level

Set/query output offset voltage

Set/query output amplitude

Set/query internal noise level

2-14 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Groups

Status Command

s. Status commands let you determine the status of the

instrument. lists and describes Status commands.

Table 2-13: Status commands

Header Description

*CLS Clear all event registers and queues

*ESE Set/query standard event status enable

*ESR?

*PSC Set/query power-on status clear

*SRE Set/query service request enable register

*STB?

STATus:OPERation:CONDition?

STATus:OPERation:ENABle Set/query operation enable register

STATus:OPERation[:EVENt]?

STATus:PRESet Preset SCPI enable register

STATus:QUEStionable:CONDition?

STATus:QUEStionable:ENABle Set/query questionable enable register

STATus:QUEStionable[:EVENt]?

Return standard event status register

Read status byte

Return operation condition register

Return operation event register

Return questionable condition register

Return questionable event register

System Commands. System commands let y ou control miscellaneous instrument functions. lists and describes System commands.

Table 2-14: System commands

Header Description

*IDN? Return identiﬁcation information

*OPT? Return option information

*RST

SYSTem:BEEPer[:IMMediate] Generate an audible tone

SYSTem:BEEPer:STATe Set/query beeper state

SYSTem:ERRor[:NEXT]?

SYSTem:KCLick[:STATe] Set/query click sound

SYSTem:KLOCk[:STATe] Set/query front panel lock/unlock

SYSTem:PASSword:CDISable

SYSTem:PASSword[:CENable] Enable protected commands to function

SYSTem:PASSword[:CENable]:STATe?

SYSTem:PASSword:NEW Change current password

SYSTem:SECurity:IMMediate Reset to factory default

SYSTem:ULANguage Set/query language for display screen

SYSTem:VERSion? Return version information

Reset

Return error event queue

Disable protected commands

Return security protection state

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-15

Command Groups

Synchronizati

on Commands. Synchronization commands let you synchronize the

operation of the instrument. lists and describes Synchronization commands.

Table 2-15: Synchronization commands

Header Description

*OPC Set/query operation complete

*WAI

Trace Comm

Wait to cont

ands. Trace commands let y ou set the edit memory and user

inue

waveform memory. lists and describes Trace commands.

Table 2-16: Trace commands

Header Description

TRACe|DATA:CATalog? Return user waveform memory status

TRACe|DATA:EMEMCOPY Copy edit memory (or user waveform

memory) content to user waveform memory

t memory)

(or edi

DATA[:DATA]

TRACe|

|DATA[:DATA]:LINE

TRACe

|DATA[:DATA]:VALue

TRACe

e|DATA:DEFine

TRAC

Ce|DATA:DELete[:NAME]

TRA

Ce|DATA:LOCK[:STATe]

TRA

TRACe|DATA:POINts Set/query number of points for waveform

ery waveform data to edit memory

Set/qu

waveform data with interpolation

Write

uery waveform data in edit memory

Set/q

dit memory content

Set e

ete user waveform memory contents

Del

/query lock/unlock of user waveform

Set memory

data in edit memory

Trigger Commands. Trigger commands let you control all aspects of arbitrary function generator triggering. lists and describes Trigger commands.

Table 2-17: Trigger commands

Header Description

ABORt

*TRG

TRIGger[:SEQuence][:IMMediate] Generate a trigger event

TRIGger[:SEQuence]:SLOPe Set/query the slope of trigger signal

TRIGger[:SEQuence]:SOURce Set/query the source of trigger signal

TRIGger[:SEQuence]:TIMer Set/query the period of internal clock

Initialize trigger system

Force trigger event

2-16 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Groups

AFG Control. AF

G Control command copies setups between two channels.

Table 2-18: AFG Control command

Header Description

AFGControl:CSCopy Copy CH1 (or CH2) setup parameters to

CH2 (or CH1)

Screen Copy. Screen copy command copies screen image.

Table 2-19: Screen copy command

Header Description

HCOPy:SDUMp[:IMMediate] Copy screen image and save the ﬁle to USB

memory.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-17

Command Groups

2-18 AFG3000 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:

ABORt (No Query Form)

Initializes all the current trigger system parameters and resets all trigger sequences.

Group

Syntax

Trigger

ABORt

No Query Form indicates set-only commands

A question mark (?) appended to the commands and Query Only indicate s 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:CONTrast command, just type DISP:CONT

Syntax of some commands varies, depending on the model of arbitrary function generator you are using; differences are noted

Arguments

Examples

None

ABORT

resets the trigger system

AFGControl:CSCopy (No Query Form)

This command copies setup parameters for one channel to another channel. If your arbitrary function generator is a single-channel model, this command is not supported.

Group

Syntax

AFG Control

AFGControl:CSCopy{CH1|CH2},{CH1|CH2}

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-19

Command Descriptions

Arguments

Examples

*CAL? (Query Only)

Group

Syntax

Related Commands

CH1|CH2

AFGCONTROL:CSCOPYCH1,CH2 copies the CH1 setup parameters into CH2.

This command performs an internal calibration and returns 0 (Pass) or a calibration error code.

NOTE. The self-calibration c an take several minutes to complete. During this

time, the arbitrary function generator does not execute any commands. Do not power off the instrument during the se

Calibration and Diagnostic

*CAL?

CALibration[:ALL]

lf-calibration.

Arguments

Returns

Examples

CALibration[:ALL]

None

<NR1>

where:

<NR1>=0 indicates that the internal calibration completed without errors.

<NR1>≠0 indicates that the arbitra ry function generator detected an error.

*CAL?

performs an internal calibration and returns results. For example, it might return 0, which indicates that the calibration completed without any errors.

The CALibration[:ALL] command performs an internal calibration.

The CALibration[:ALL]? command performs an internal calibration and returns 0 (Pass) or a calibration error code.

2-20 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Group

Syntax

Related Commands

Arguments

Returns

NOTE. The self-

time, the arbitrary function generator does not execute any commands. Do not power off the instrument during the self-calibration.

Calibration and Diagnostic

CALibration[:ALL] CALibration[:ALL]?

*CAL?

None

<NR1>

where:

<NR1>=0 indicates that the internal calibration completed without errors.

<NR1>≠0 indicates that the arbitrary function generator detected an error.

calibration can take several minutes to complete. During this

Examples

*CLS (No Query Form)

Group

Syntax

Arguments

CALIBRATION[:ALL]

performs an internal calibration.

CALIBRATION[:ALL]?

performs an internal calibration and returns results. For example, it might return 0, which indicates that the calibration completed without any errors.

This command clears all the event registers and queues, which are used in the arbitrary function generator status and event reporting system.

Status

*CLS

None

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-21

Command Descriptions

Examples

DIAGnostic[:ALL]

Group

Syntax

Related Commands

*CLS

clears all the event registers and queues.

The DIAGnostic[:ALL] command performs a self-test. The DIAGnostic[:ALL]? command returns the results after executing the test.

NOTE. The self-test can take several minutes to complete. During this time, the

arbitrary function generator does not exec off the instrument during the self-test.

Calibration and Diagnostic

DIAGnostic[:ALL] DIAGnostic[:ALL]?

*TST?

ute any commands. Do not power

Arguments

Returns

Examples

DISPlay:BRIGHtness

None

<NR1>

where:

<NR1>=0 indicates that the self-test completed without errors.

<NR1>≠0 indicates that the arbitra ry function generator detected an error.

DIAGNOSTIC[:ALL]

performs a self-test.

DIAGNOSTIC[:ALL]?

performs a self-test and returns a number indicating the ou

This command sets or queries the brightness of the LCD display.

tcome of the self-test.

2-22 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Group

Syntax

Arguments

Returns

Examples

NOTE. The comma

Display

DISPlay:BRIGHtness {|MINimum|MAXimum} DISPlay:BRIGHtness? [MINimum|MAXimum]

where:

<NR2> is a range of display brightness from 0.00 through 1.00 (resolution: 3 digits). The larger the value, the greater the screen brightness.

MINimum sets the display to the lowest brightness level (0.00).

MAXimum sets the display to the highest brightness level (1.00).

<NR2>

DISPlay:BRIGhtness MAXimum sets the display brightness to the highest

brightness level.

nd is available for the AFG3000C series instruments.

DISPlay:CONTrast

Group

Syntax

Arguments

This command sets or queries the contrast of the LCD display.

NOTE. The command is available for the AFG3000 series and AFG3000B series

instruments.

Display

DISPlay:CONTrast {<contrast>|MINimum|MAXimum} DISPlay:CONTrast?

where:

<NR2> is a range of d isplay contrast from 0.00 through 1.00 (resolution: 3 digits). The larger the value, the greater the screen contrast.

MINimum sets the display to the 0 contrast level.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-23

Command Descriptions

e display to the largest contrast level.

Returns

Examples

MAXimum sets th

<NR2>

DISPLAY:CONTRAST MAXIMUM

sets the display contrast to the largest contrast level.

DISPlay:SAVer:IMMediate (No Query Form)

This command sets the scr een saver state to ON, regardless of the DISPlay:SAVer[:STATe]? command setting.

The screen saver is enabled immediately (without waiting for ﬁve minu tes).

Group

Syntax

Display

DISPlay:SAVer:IMMediate

Related Commands

Arguments

Examples

DISPlay:SAVer[:STATe]

Group

Syntax

DISPlay:SAVer[:STATe]

None

DISPLAY:SAVER:IMMEDIATE

sets the screen saver state to ON.

This command sets or queries the screen saver setting of the LCD display. When enabled, the screen saver function starts automatically if no operations are applied to the instrument front panel for ﬁve minutes.

Display

DISPlay:SAVer[:STATe] {ON|OFF|<NR1>} DISPlay:SAVer[:STATe]?

Related Commands

2-24 AFG3000 Series Arbitrary Function Generator Programmer Manual

DISPlay:SAVer:IMMediate

Command Descriptions

Arguments

Returns

Examples

ON or <NR1>≠0en

OFF or <NR1>=0 disables the screen saver function.

<NR1>

indicating the screen saver state.

DISPLAY:SAVER[:STATE] OFF

disables the screen saver function.

DISPlay[:WINDow]:TEXT[:DATA]

The DISPlay[:WINDow]:TEXT[:DATA] command displays a text message on the instrument screen.

The DISPlay[:WINDow]:TEXT[:DATA]? query return displayed on the instrument screen.

The displayable characters are ASCII codes 32 through 126, and the instrument can display approximately 64 characters.

ables the screen saver function.

s the text string currently

Group

Syntax

Arguments

Returns

Examples

Display

DISPlay[:WINDow]:TEXT[:DATA] <string> DISPlay[:WINDow]:TEXT[:DATA]?

which is the currently displayed text message.

DISPLAY[:WINDOW]:TEXT[:DATA]?

returns the currently displayed text message.

DISPlay[:WINDow]:TEXT:CLEar (No Query Form)

This command clears the text message from the display screen.

Group

Display

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-25

Command Descriptions

*ESE

Syntax

Arguments

Examples

Group

Syntax

DISPlay[:WIND

None

DISPLAY[:WINDOW]:TEXT:CLEAR

clears the text message from the screen.

This command sets or queries the bits in the Event Status Enable Register (ESER) used in the status and events reporting system of the arbitrary function generator. The query command returns the contents of the ESER.

Status

*ESE <bit_value> *ESE?

ow]:TEXT:CLEar

Related Commands

Arguments

Returns

Examples

*CLS*ESR?*PSC*SRE*STB?

<bit_value>::=<NR1>

where:

<NR1> is a value in the range of 0 through 255. The binary bits of the ESER are set according to this value.

<bit_value>

*ESE 177

sets the ESER to 177 (binary 10110001), which sets the PON, CME, EXE and OPC bits.

*ESE?

might return 186, indicating that the ESER contains the binary value 10111010.

2-26 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

*ESR? (Query O

Related Commands

Arguments

Returns

Examples

nly)

Group

Syntax

This query-only command returns the contents of the Standard Event Status Register (SESR) used in the status events reporting system in the arbitrary function gen

Status

*ESR?

*CLS*ESE*SRE*STB?

None

<NR1>

indicates that the contents of the SESR as a decimal inte

*ESR?

erator. *ESR also clears the SESR (since reading the SESR clears it).

ger.

might return 181, which indicates that the SESR contains the binary number

10110101.

HCOPy:SDUMp[:IMMediate] (No Query Form)

This command copies a screen image and saves the image ﬁle to a USB memory. The default ﬁle name is TEK00nnn.BMP, where nnn is a consecutive number from 000 through 999. The image ﬁlesaresavedinafoldernamed“TEK”in the USB memory.

Group

Syntax

Arguments

Examples

Screen copy

HCOPy:SDUMp[:IMMediate]

None

HCOPY:SDUMP[:IMMEDIATE]

copies the screen image and may create a ﬁle TEK00001.BMP in a USB memory.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-27

Command Descriptions

*IDN? (Query O

Arguments

nly)

Group

Syntax

Returns

This query-only command returns identiﬁcation information on the arbitrary function generator.

System

*IDN?

None

where:

<Manufacturer>::=TEKTRONIX

<Model>::={AFG3021}

<Firmware Level> ::=SCPI:99.0 FV:2.0

Examples

*IDN?

might return the following response:

TEKTRONIX,AFG3021,C100101,SCPI:9 9.0 FV:1.0

MEMory:STATe:DELete (No Query Form)

This command deletes the contents of speciﬁed setup mem ory. If a speciﬁed setup memory is not allowed to overwrite or delete, this command causes an error.

Group

Syntax

Arguments

Examples

Memory

MEMory:STATe:DELete {0|1|2|3|4}

0, 1, 2, 3, or 4 speciﬁes the location of setup memory.

MEMORY:STATE:DELETE 1

deletes the contents of speciﬁed setup memory.

2-28 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

MEMory:STATe

Arguments

:LOCK

Group

Syntax

This command sets or que ries whether to lock the speciﬁed setup memory. If you lock a setup memory, you cannot overwrite or delete the setup ﬁle.

You cannot execute this command for the setup memory of location number 0 (last setup memory).

Memory

MEMory:STATe:LOCK {1|2|3|4},{ON|OFF|<NR1>} MEMory:STATe:LOCK? {1|2|3|4}

0, 1, 2, 3, or 4 speciﬁes the setup memory to locked or queried.

ON or <NR1>≠0 locks the speciﬁed location of setup memory.

OFF or <NR1>=0 allows you to overwrite or delete the speciﬁed location of setup memory.

Returns

Examples

<NR1>

MEMORY:STATE:LOCK 1,ON

locks the setup memory of location number 1.

MEMory:STATe:RECall:AUTo

This command sets or queries whether to enable the automatic recall of last setup memory when powered-on. The next time you apply the power, the arbitrary function generator will automatically recall the settings you used when you powered off the instrument.

If you select OFF, the default setups arerecalledwhenyoupoweronthe instrument.

Group

Syntax

Memory

MEMory:STATe:RECall:AUTo {ON|OFF|<NR1>} MEMory:STATe:RECall:AUTo?

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-29

Command Descriptions

Arguments

Returns

Examples

OFF or <NR1>=0 d

ON or <NR1>≠0enablestherecallofthesetupmemorylastusedbeforethe instrument wa

<NR1>

MEMORY:STATE:RECALL:AUTO ON

sets the instrument to recall the last setup memory when powered-on.

s powered off.

MEMory:STATe:VALid? (Query Only)

This command returns the availability of a setup memory.

Group

Syntax

Memory

MEMory:STATe:VALid? {0|1|2|3|4}

isables the last setup recall function.

MMEMory:C

Arguments

Returns

Examples

0, 1, 2, 3, or 4 speciﬁes the location of setup memory.

<NR1>

1 means that the speci ﬁed setup memory has been saved.

0 means that the speciﬁed setup memory has been deleted.

MEMORY:STATE:VALID? 0 might return 1 if the speciﬁedsetupmemoryhas

been saved.

ATalog? (Query Only)

This query-only command returns the current state of the mass storage system (USB memory).

Group

Syntax

Mass Memory

MMEMory:CATalog?

2-30 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Related Commands

Arguments

Returns

Examples

MMEMory:CDIRe

None

<NR1>,<NR1>[,<file_name>,<file_t ype >,< fil e_si ze> ].. .

where:

The ﬁrst <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.

<ﬁle_name> is the exact name of a ﬁle.

<ﬁle_type> is DIR for directory, otherwise it is blank.

<ﬁle_size> is the size of the ﬁle, in bytes.

MMEMORY:CATALOG? might return the following response:

32751616,27970560,”SAMPLE1.TFS,, 541 2”

ctory

MMEMory:CDIRectory

Group

Syntax

Arguments

Returns

Examples

This command changes the current working directory in the mass storage system.

Mass Memory

MMEMory:CDIRectory [<directory_name>] MMEMory:CDIRectory?

<directory_name>::=<string> indicates the current working directory for the mass storage system.

If you do not specify a parameter, the directory is set to the *RST value. At *RST, this parameter is set to the root.

<directo

MMEMORY:CDIRECTORY ”/AFG/WORK0”

ry_name>::=<string>

changes the current directory to /AFG/WORK0.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-31

Command Descriptions

MMEMory:DELe

te (No Query Form)

This command deletes a ﬁle or directory from the mass storage system. If a speciﬁed ﬁle in the mass storage is not allowed to overwrite or delete, this command caus

Group

Syntax

Arguments

Examples

Mass Memory

MMEMory:DELete <file_name>

<ﬁle_name>::=<string> speciﬁes a ﬁle to be deleted.

MMEMORY:DELETE ”TEK001.TFW”

deletes the speciﬁed ﬁle from the mass storage.

es an error. You can delete a directory if it is empty.

MMEMory:LOAD:STATe (No Query Form)

This command copies a setup ﬁle in the mass storage system to an internal setup memory. If a speciﬁed internal setup memory is locked, this command causes an error.

Group

Syntax

Related Commands

Arguments

Examples

When you power off the instrument, the setups are automatically overwritten in the setup memory 0 (last setup memory).

Mass Memory

MMEMory:LOAD:STATe {0|1|2|3|4},<file_name>

MEMory:STATe:LOCKMEMory:STATe:RECall:AUToMMEMory:STORe: STATe

0, 1, 2, 3, or 4 speciﬁes the location of setup memory.

<ﬁle_name>::=<string> speciﬁes a setup ﬁle to be copied.

MMEMORY:LOAD:STATE 1,”SETUP1.TFS”

copies a ﬁle named SETUP1.TFS in the mass storage into the internal memory location 1.

2-32 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

MMEMory:LOAD

Syntax

Related Commands

Arguments

Examples

:TRACe (No Query Form)

This command copies a waveform data ﬁle in the mass storage system to Edit Memory. If the ﬁle format is different, this command causes an error.

Group

Mass Memory

MMEMory:LOAD:T

MMEMory:STORe:TRACe

EMEMory|EMEMory[1]|EMEMory2 refers to the Commands Arguments column in Table B-1 in Appendix B.

<ﬁle_name>::=<string> speciﬁes a waveform data ﬁle to be copied.

MMEMORY:LOAD:TRACE E MEM ory 1,” TEK 001 .TF

copies a ﬁle named TEK001.TFW in the mass storage into Edit Memory 1.

RACe

EMEMory|EMEMory[1]|EMEMory2,<file_name>

W”

MMEMory:LOCK[:STATe]

This command sets or queries whether to lock a ﬁle or directory in the mass storage system. If you lock a ﬁle or directory, you cannot overwrite or delete it.

Group

Syntax

Arguments

Returns

Examples

Mass Memory

MMEMory:LOCK[:STATe] <file_name>,{ON|OFF|<NR1>} MMEMory:LOCK[:STATe]<file_name>?

ON or <NR1>≠0 locks a ﬁle or directory in the mass storage system.

OFF or <NR1>=0 allow s you to overwrite or delete a ﬁle or directory in the mass storage system.

<NR1>

MMEMORY:LOCK[:STATE] ”SETUP1.TFS”,ON

locks the ﬁle “SETUP1.TFS”.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-33

Command Descriptions

MMEMory:MDIR

ectory (No Query Form)

This command creates a directory in the mass storage system . If the speciﬁed directory is locked in the mass storage system, this command causes an error.

Group

Syntax

Arguments

Examples

Mass Memory

MMEMory:MDIRectory <directory_name>

<directory_name>::=<string> speciﬁes a directory name to be created.

MMEMORY:MDIRECTORY ”SAMPLE1”

creates a directory named “SAMPLE1” in the mass storage system.

MMEMory:STORe:STATe (No Query Form)

This command copies a setup ﬁle in the setup mem o ry to a speciﬁed ﬁle in the mass storage system. If the speciﬁed ﬁle in the mass storage system is locked, this command causes an error. You cannot create a new ﬁle if the directory is locked. If the setup m e mory is deleted, this command causes an error. The <ﬁle_name> argument is a quoted string that deﬁnes the ﬁle name and path.

Group

Syntax

Related Commands

Arguments

Examples

Mass Memory

MMEMory:STORe:STATe {0|1|2|3|4},<file_name>

MMEMory:LOAD:STATeMMEMory:LOCK[:STATe]

0, 1, 2, 3, or 4 speciﬁes the location of setup memory.

<ﬁle_name>::=<string> speciﬁes a ﬁle name in the mass storage system. The <ﬁle_name> includes path. Path separators are forward slashes (/).

MMEMORY:STORE:STATE 1,”SETUP1.TFS”

Copies the setup ﬁle in the setup memory location 1 to a ﬁle named “SETUP1.TFS” in the mass storage system.

2-34 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

MMEMory:STOR

Syntax

Related Commands

Arguments

Examples

e:TRACe(NoQueryForm)

This command copies a waveform data ﬁle in the Edit M emory to a ﬁle in the mass storage system. If the ﬁle in the mass storage is locked, this command causes

cannot create a new ﬁle if the directory is locked.

Group

an error. You

Mass Memory

MMEMory:STORe:TRACe EMEMory[1]|EMEMory2,<file_name>

MMEMory:LOCK[:STATe]MMEMory:LOAD:TRACe

<ﬁle_name>::=<string> speciﬁes a ﬁle name in the mass storage system. The <ﬁle_name> includes path. Path separators are forward slashes (/).

MMEMORY:STORE:TRACE EMEMory1,”SAMPLE1.TFW”

Copies the content of EMEMory1 to a ﬁle named “SAMPLE1.TFW” in the mass storage system.

*OPC

Group

Syntax

Arguments

Returns

This command generates the operation complete message by setting bit 0 in the Standard Event Status Register (SESR) when all pending commands that generate an OPC message are complete.

The query command places the ASCII character “1” into the output queue when all such OPC commands are complete.

Synchronization

*OPC *OPC?

None

<execution complete> ::=1

where “1” indicates that all pending operations are complete.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-35

Command Descriptions

*OPT? (Query

Arguments

Examples

Only)

Group

Syntax

Returns

Examples

*OPC?

might return 1 to indicate that all pending OPC operations are ﬁnished.

This query-only command returns a list of the options installed in your arbitrary function generator.

System

*OPT?

None

<OPT>[,<OPT>[,<OPT>[,<OPT>]]]

*OPT?

OUTPut[1|2]:IMPedance

Group

Syntax

Arguments

might return 0, which indicates no option is installed in the instrument.

The OUTPut:IMPedance command sets the output load impedance for the speciﬁed channel. The speciﬁed value is used for amplitude, offset, and high/low level settings. You can set the impedance to any value from 1 Ω to 10 kΩ with a resolution of 1 Ω or 3 digits. The default value is 50 Ω .

The OUTPut:IMPedance? command returns the current load impedance setting in ohms. If the load impedance is set to INFinity, the query command returns “9.9E+37”.

Output

OUTPut[1|2]:IMPedance {<ohms>|INFinity|MINimum|MAXimum} OUTPut[1|2]:IMPedance?

<ohms>::=<NR3>[<units>]

where:

2-36 AFG3000 Series Arbitrary Function Generator Programmer Manual

<units>::=OHM

INFinity sets the load impedance to >10 kΩ.

MINimum sets the load impedance to 1 Ω.

MAXimum sets the load impedance to 10 kΩ.

Command Descriptions

Returns

Examples

OUTPut[1|2]:POLarity

Group

Syntax

Arguments

OUTPut1:IMPedance MAXimum

sets the CH 1 load impedance to 10 kΩ .

This command inverts a speciﬁed output waveform relative to the offset level. The query command returns the polarity for the speciﬁed channel.

Output

OUTPut[1|2]:POLarity {NORMal|INVerted} OUTPut[1|2]:POLarity?

NORMal sets the speciﬁed output waveform polarity to Normal.

INVerted sets the speciﬁed output waveform polarity to Inverted.

Returns

Examples

NORM|INV

OUTPut1:POLarity NORMal

sets the CH 1 waveform polarity to Normal.

OUTPut[1|2][:STATe]

This command sets or query whether to enable the arbitrary function generator output for the speciﬁed channel.

Group

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-37

Output

Command Descriptions

Syntax

Arguments

Returns

Examples

OUTPut:TRIGger:MODE

OUTPut[1|2][: OUTPut[1|2][:STATe]?

ON or <NR1>≠0 enables the arbitrary function generator output.

OFF or <NR1>=0 disables the arbitrary function generator output.

<NR1>

OUTPUT1:STATE ON sets the arbitrary function generator CH 1 output to ON.

This command sets or queries the mode (trigger or sync) for Trigger Output signal.

When the burst count is set to Inf-Cycles in burst mode, T RIGger indicates that the inﬁnite number of cycles of waveform will be output from the Trigger Output connector.

When the burst count is set to Inf-Cycles in burst mode, SYNC indicates that one pulse waveform is output from the Trigger Output connector when the Inf-Cycles starts.

STATe]

{ON|OFF|<NR1>}

Group

Syntax

Arguments

Returns

Examples

When Run Mode is speciﬁed other than Burst Inf-Cycles, TRIGger and SYNC have the same effect.

Output

OUTPut:TRIGger:MODE {TRIGger|SYNC} OUTPut:TRIGger:MODE?

TRIGger means TRIGger is selected for Trigger Out.

SYNC means SYNC is selected for Trigger Out.

TRIG|SYNC

OUTPUT:TRIGGER:MODE SYNC

outputs one cycle waveform from the Trigger Output connector when Inf-Cycles starts.

2-38 AFG3000 Series Arbitrary Function Generator Programmer Manual

*PSC

Command Descriptions

This command sets and queries the power-on status ﬂag that controls the automatic power-on execution of SRER and ESER. When *PSC is true, SRER and ESER are s SRER and ESER are preserved in nonvolatile memory when power is shut off and are restored at power-on.

et to 0 at power-on. When *PSC is false, the current values in the

Group

Syntax

Arguments

Returns

Examples

*RCL (No Query Form)

Status

*PSC <NR1> *PSC?

<NR1>=0 sets the power-on status clear ﬂag to false, disables the pow er-on c lear, and allows the instrument to possibly assert SRQ after power-on.

<NR1>≠0 sets the power-on status clear ﬂag true. Sending *PSC 1 therefore enables the power-on status clear and prevents any SRQ assertion after power-on.

<NR1>

*PSC 0

sets the power-on status clear ﬂag to false.

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 speciﬁed setup mem ory is deleted, this command causes an error.

Group

Syntax

Related Commands

Arguments

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-39

Memory

*RCL {0|1|2|3|4}

*SAV

0, 1, 2, 3, or 4 speciﬁes the location of setup memory.

Command Descriptions

Examples

*RST (No Query Form)

Group

Syntax

Arguments

Examples

*RCL 3

restores the instrument from a copy of the settings stored in memory location 3.

This command resets the instrument to the factory default settings. This command is equivalent to pushing the Default button on the front panel. The d efault values are listed in Default Settings.

System

*RST

None

*RST

*SAV (No Query Form)

Group

Syntax

Related Commands

resets the arbitrary function generator settings to the factory defaults.

This command stores the current settings of the arbitrary function generator to a speciﬁedsetupmemorylocation.

A setup memory location numbered 0 ( last setup memory) is automatically overwritten by the setups when you power off the instrument.

If a speciﬁed numbered setup memory is locked, this command causes an error.

Memory

*SAV {0|1|2|3|4}

*RCL

Arguments

2-40 AFG3000 Series Arbitrary Function Generator Programmer Manual

0, 1, 2, 3, or 4 speciﬁes the l

ocation of setup memory.

Command Descriptions

Examples

*SAV 2

saves the current instrument state in the memory location 2.

[SOURce[1|2]]:AM[:DEPTh]

This command s ets or queries the modulation depth of AM modulation for the speciﬁed channel. You can set the modulation depth from 0.0% to 120.0% with resolution of 0.1%.

Group

Syntax

Arguments

Source

[SOURce[1|2]]:AM[:DEPTh] {<depth>|MINimum|MAXimum} [SOURce[1|2]]:AM[:DEPTh]?

<depth>::=<NR2>[<units>]

where:

<NR2> is the depth of modulating frequency.

<units>::=PCT

MINimum sets the modulation depth to minimum value.

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 s peciﬁed channel. You can use this command only when the internal modulation source is selected. You can set the internal modulation frequency from 2 mHz to 50.00 kHz with resolution of 1 mHz.

You can select the source of modulating signal by using the [SOURce[1|2]]:AM:SOURce [INTernal|EXTernal] command.

Group

Source

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-41

Command Descriptions

Syntax

Related Commands

Arguments

Returns

Examples

[SOURce[1|2]]

{<frequency>|MINimum|MAXimum}

[SOURce[1|2]]:AM:INTernal:FREQue ncy ?

:AM:INTernal:FREQuency

[SOURce[1|2]]:AM:SOURce

<frequency>::=<NRf>[<units>]

where:

<NRf> is the modulation frequency.

<units>::=[Hz | kHz | MHz]

SOURce1:AM:INTernal:FREQuency 10kHz

sets the CH 1 internal modulation frequency to 10 kHz.

[SOURce[1|2]]:AM:INTe rnal:FUNCtion

This command sets or queries the modulating waveform of AM modulation for the speciﬁed channel. You can use this com mand only when the inter nal modulation source is selected.

If you specify EFILe when there is no EFILe or the EFILe is not yet deﬁned, this command causes an error.

Group

Syntax

Related Commands

Arguments

Source

[SOURce[1|2]]:AM:INTernal:FUNCti on

{SINusoid|SQUare|TRIangle|RAMP |NRAMp|PRNoise| USER[1]|USER2|USER3|USER4|EMEMory[1]|EMEMory2|EFILe}

[SOURce[1|2]]:AM:INTernal:FUNCti on?

[SOURce[1|2]]:AM:SOURce[SOURce[1|2]]:AM:INTernal:FUNCtion:EFILe

One of six types of function waveform can be selected as a modulating signal.

2-42 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

veform saved in the user waveform memory or the EMEMory

Returns

Examples

Auserdeﬁned wa can be selected as a modulating signal.

EFILe

EFILe is used as a modulating signal.

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 ﬁle name must be speciﬁed in the mass storage system. This command returns “ ” if there is no ﬁle in the mass storage.

Group

Source

Syntax

Arguments

Returns

Examples

[SOURce[1|2]]:AM:INTernal:FUNCti on: EFI Le <file_name> [SOURce[1|2]]:AM:INTernal:FUNCti on: EFI Le?

<ﬁle_name>::=<string> speciﬁes a ﬁle name in the mass storage system. The <ﬁle_name> includes path. Path separators are forward slashes (/).

<file_name>

SOURce1:AM:INTernal:FUNCtion:EFI Le “SAMPLE1”

sets a ﬁle named “SAMPLE1” in the mass storage.

[SOURce[1|2]]:AM:SOURce

This command sets or queries the source of modulating signal of AM modulation for the speciﬁed channel.

Group

Source

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-43

Command Descriptions

Syntax

Arguments

Returns

Examples

[SOURce[1|2]] [SOURce[1|2]]:AM:SOURce?

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:AM:SOURce INTernal

sets the CH 1 source of modulating signal to internal.

[SOURce[1|2]]:AM:STATe

This command enables or disables AM modulation for the speciﬁed channel. The query command returns the state of AM modulation.

Group

Source

:AM:SOURce

[INTernal|EXTernal]

Syntax

Arguments

Returns

Examples

[SOURce[1|2]]:AM:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:AM:STATe?

or <NR1>≠0 enables AM modulation.

OFF or <NR1>=0 disables AM modulation.

<NR1>

SOURce1:AM:STATe ON

enables the CH 1 AM modulation.

[SOURce[1|2]]:BURSt:MODE

This command sets or queries the burst mode for the speciﬁed channel.

Group

Source

2-44 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Syntax

Arguments

Returns

Examples

[SOURce[1|2]] [SOURce[1|2]]:BURSt:MODE?

TRIGgered means that triggered mode is selected for burst mode.

GATed means that gated m ode is selected for burst mode.

TRIG|GAT

SOURce1:BURSt:MODE TRIGgered

selects triggered mode.

[SOURce[1|2]]:BURSt:NCYCles

This command sets or queries the number of cycles (burst count) to be output in burst mode for the speciﬁed channel. The query comm and returns 9.9E+37 if the burst count is set to INFinity.

:BURSt:MODE

{TRIGgered|GATed}

Group

Syntax

Arguments

Returns

Examples

Source

[SOURce[1|2]]:BURSt:NCYCles {<cycles>|INFinity|MINimum| MAXimum} [SOURce[1|2]]:BURSt:NCYCles?

where:

<NRf> is the burst count. The burst count ranges from 1 to 1,000,000.

INFinity sets the burst count to inﬁnite count.

MINimum sets the burst count to minimum count.

MAXimum sets the burst count to maximum count.

SOURce1:BURSt:NCYCles 2

sets the CH 1 burst count to 2.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-45

Command Descriptions

[SOURce[1|2]

Arguments

]:BURSt[:STATe]

This command enables or disables the burst mode for the speciﬁed channel. The query command returns the state of burst mode.

Group

Syntax

Returns

Examples

Source

[SOURce[1|2]]:BURSt[:STATe] {ON|OFF|<NR1>} [SOURce[1|2]]:BURSt[:STATe]?

ON or <NR1>≠0 enables the burst mode.

OFF or <NR1>=0 disables the burst mode.

<NR1>

SOURce1:BURSt:STATe ON

enables the burst mode for the CH 1.

[SOURce[1|2]]:BURSt:TDELay

is command sets or queries delay time in the burst mode for the speciﬁed

Th channel. It speciﬁes a time delay between the trigger and the signal output. This command is available only in the Triggered burst mode.

The setting range is 0.0 ns to 85.000 s with resolution of 100 ps or 5 digits.

Group

Syntax

Arguments

Source

[SOURce[1|2]]:BURSt:TDELay {<delay>|MINimum|MAXimum} [SOURce[1|2]]:BURSt:TDELay?

<delay>::=<NRf>[<units>]

where:

<units>::=[s | ms | μs | ns]

MINimum sets the delay time to minimum value.

MAXimum sets the delay time to maximum value.

2-46 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Returns

Examples

<delay>

SOURce1:BURSt:DELay 20ms sets the CH 1 delay time to 20 m s.

[SOURce[1|2]]:COMBine:FEED

This command sets or queries whether to add the internal noise or an external signal to an output signal for the speciﬁed channel.

When yo u specify the internal nois e, you can set or query the noise level by SOURce<3|4>:POWer[:LEVel][:IMMediate][:AMPLitude] command.

To disable the internal noise add or the external signal add function, specify “”.

You can add an external signal to the CH 1 output signal of the AFG3100 and AFG3200 series arbitrary function generators.

The CH 2 output is not available for adding external signal.

Both the internal noise and an external signal can be added simultaneously to the arbitrary function generator.

Group

Syntax

Related Commands

Arguments

Returns

Examples

Source

SOURce<3|4>:POWer[:LEVel][:IMMediate][:AMPLitude]

NOISe indicates that the internal noise is added to the output signal.

EXTernal indicates that an external signal is added to the CH 1 output signal of the AFG3100 or AFG3200 series arbitrary function generators.

BOTH indicates that the internal noise and an external signal are added to the CH 1 output signal of the AFG3100 or AFG3200 series arbitrary function generators.

“” disables the internal noise add and external signal add function.

“NOIS”|“EXT”|“BOTH”|“”

SOURce1:COMBine:FEED EXTernal

adds an external signal to the CH 1 output signal.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-47

Command Descriptions

[SOURce[1|2]

Arguments

]:FM[:DEViation]

This command sets or queries the peak frequency deviation of FM modulation for the speciﬁed channel. The setting range of frequency deviation depends on the wavefo the speciﬁcations in the AFG3000 Series Speciﬁcations and Performance Ver iﬁcation Technical Reference, which can be found on the Tektronix Web site (www.tektronix.com/downloads).

Group

Syntax

Source

[SOURce[1|2]]:FM[:DEViation] {<deviation>|MINimum|MAXimum} [SOURce[1|2]]:FM[:DEViation]?

<deviation>::=<NRf>[<units>]

where:

<NRf> i s the frequency deviation.

<units>::=[Hz | kHz | MHz]

rm selected as the carrier. For more information, refer to

Returns

Examples

SOURce1:FM:DEViation 1.0MHz

sets the CH 1 frequency deviation to 1.0 MHz.

[SOURce[1|2]]:FM:INTernal:FREQuency

This command sets or queries the internal modulation frequency of FM modulation for the speciﬁed channel. You can use this command only when the internal modulation source is selected.

You can set the internal modulation frequency from 2 mHz to 50.00 kHz with resolution of 1 mHz.

You can select the source of modulating signal by using the [SOURce[1|2]]:FM:SOURce [INTernal|EXTernal] command.

Group

Syntax

Source

[SOURce[1|2]]:FM:INTernal:FREQue ncy

{<frequency>|MINimum|MAXimum}

2-48 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

:FM:INTernal:FREQuency?

Related Commands

Arguments

[SOURce[1|2]]

[SOURce[1|2]]:FM:SOURce

<frequency>::=<NRf>[<units>]

where:

<NRf> is the modulation frequency.

<units>::=[Hz | kHz | MHz]

Returns

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 speciﬁed channel. You can use this command only when the internal modulation source is selected.

Group

Syntax

Related Commands

Arguments

If you specify EFILe when there is no EFILe or the EFILe is not yet deﬁned, this command causes an error.

Source

[SOURce[1|2]]:FM:INTernal:FUNCti on

{SINusoid|SQUare|TRIangle| RAMP| NRAMp| PRNoise| USER[1]| USER2|USER3|USER4|EMEMory[1]|EMEMory2|EFILe}

[SOURce[1|2]]:FM:INTernal:FUNCti on?

[SOURce[1|2]]:FM:SOURce

One of six types of function waveform can be selected as a modulating signal.

Auserdeﬁned waveform saved in the user w aveform memory or the EMEM can be selected as a modulating signal.

EFILe

ory

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-49

Command Descriptions

a modulating signal.

Returns

Examples

EFILe is used as

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 ﬁle name must be speciﬁed in the mass storage system. This command returns “ ” if there is no ﬁle in the mass storage.

Group

Syntax

Source

[SOURce[1|2]]:FM:INTernal:FUNCti on: EFI Le <file_name> [SOURce[1|2]]:FM:INTernal:FUNCti on: EFI Le?

Arguments

Returns

Examples

<ﬁle_name>::=<string> speciﬁes a ﬁle name in the mass storage system. The <ﬁle_name> includes path. Path separators are forward slashes (/).

<file_name>

SOURce1:FM:INTernal:FUNCtion:EFI Le “SAMPLE1”

sets a ﬁle named “SAMPLE1” in the mass storage.

[SOURce[1|2]]:FM:SOURce

This command sets or queries the source of modulating signal of FM modulation for the speciﬁed channel.

Group

Syntax

Source

[SOURce[1|2]]:FM:SOURce [INTernal|EXTernal] [SOURce[1|2]]:FM:SOURce?

2-50 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Arguments

Returns

Examples

INTernal means

EXTernal means that the carrier waveform is modulated with an external source.

INT|EXT

SOURce1:FM:SOURce INTernal

sets the CH 1 source of modulating signal to internal.

[SOURce[1|2]]:FM:STATe

This command enables or disables FM modulation. The query command returns the state of FM modulation.

Group

Syntax

Source

[SOURce[1|2]]:FM:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:FM:STATe?

that the carrier waveform is modulated with the internal source.

Arguments

Returns

Examples

ON or <NR1>≠0 enables FM modulation.

OFF or < NR1>=0 disables FM modulation.

<NR1>

SOURce1:FM:STATe ON

enables the CH 1 FM modulation.

[SOURce[1|2]]:FREQuency:CENTe r

This command sets or queries the center frequency of sweep for the speciﬁed channel. This command is always used with the [SOURce[1|2]]:FREQuency:SPAN command. The setting range of center frequency depends on the waveform selected for sweep.

Group

Syntax

Source

[SOURce[1|2]]:FREQuency:CENTer {<frequency>|MINimum|MAXimum} [SOURce[1|2]]:FREQuency:CENTer?

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-51

Command Descriptions

Related Commands

Arguments

Returns

Examples

[SOURce[1|2]]

<frequency>::=<NRf>[<units>]

where:

<NRf> is the center frequency.

<units>::=[Hz | kHz | MHz]

SOURce1:FREQuency:CENTer 550kHz

sets the CH 1 center frequency to 550 kHz.

:FREQuency:SPAN[SOURce[1|2]]:FREQuency:MODE

[SOURce[1|2]]:FREQuency:CONCurrent[:STATe]

This command enables or disables the function to copy the frequency (or period) of one channel to another channel.

The

[SOURce[1|2]]:FREQuency:CONCurre nt command copies the frequency

(or period) of the channel speciﬁed by the h ea de r sufﬁx to another channel. If you specify CH 1 with the header, the CH 1 frequency will be copied to CH 2.

Group

Syntax

Arguments

Returns

Examples

The

[SOURce[1|2]]:FREQuency:CONCurren t? command returns “0” (off)

or “1” (on).

If your arbitrary function generator is single-channel model, this command is not supported.

Source

[SOURce[1|2]]:FREQuency:CONCurre nt[ :ST ATe ] {ON|OFF|<NR1>} [SOURce[1|2]]:FREQuency:CONCurre nt[ :ST ATe ]?

ON or <NR1>≠0 enables the concurrent copy function.

OFF or <NR1>=0 disables the concurrent copy function.

<NR1>

SOURce1:FREQuency:CONCurrent ON

copies the frequency value of CH 1 to CH 2.

2-52 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

[SOURce[1|2]

Arguments

]:FREQuency[:CW|:FIXed]

This command sets or queries the frequency of output waveform for the speciﬁed 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. If

he type of output waveform, it might change the output frequency

ency>::=<NRf>[<units>]

Group

Syntax

you change t because changing waveform types impacts on the setting range of output frequency. The resolution is 1 μHz or 12 digits. For more information on the setting range, refer to the AFG3000 Series Speciﬁcations and Performance Ver iﬁcation Technical Reference, which can be found on the Tektronix Web site (www.tektronix.com/downloads).

Source

[SOURce[1|2]]:FREQuency[:CW|:FIX ed]

{<frequency>|MINimum|MAXimum}

[SOURce[1|2]]:FREQuency[:CW|:FIX ed] ?

<frequ

where:

<NRf> is the output frequency.

s>::=[Hz|kHz|MHz]

<unit

Returns

Examples

SOURce1:FREQuency:FIXed 500kHz

sets the CH 1 output frequency to 500 kHz when the Run Mode is set to other than Sweep.

[SOURce[1|2]]:FREQuency:MODE

This command sets or queries the frequency sweep state. You can select sine, square, ramp, or arbitrary waveform for swe ep. The arbitrary function generator automatically changes to the Continuous mode if any waveform is selected other than sine, square, ramp, or an arbitrary waveform.

Group

Source

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-53

Command Descriptions

Syntax

Related Commands

Arguments

Returns

Examples

[SOURce[1|2]] [SOURce[1|2]]:FREQuency:MODE?

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.

CW|FIXed|SWEep

SOURce1:FREQuency:MODE SWEep speciﬁes the sweep command set for

controlling the CH 1 output frequency.

[SOURce[1|2]]:FREQuency:SPAN

:FREQuency:MODE

{CW|FIXed|SWEep}

Group

Syntax

Related Commands

Arguments

Returns

This command sets or queries the span of frequency sweep for the speciﬁed channel. This command is alw ays used with the [SOURce[1|2]]:FREQuency:CENTer command. The setting range of frequency span depends on the waveform selected for sw eep.

Source

[SOURce[1|2]]:FREQuency:SPAN {<frequency>|MINimum|MAXimum} [SOURce[1|2]]:FREQuency:SPAN

[SOURce[1|2]]:FREQuency:CENTer[SOURce[1|2]]:FREQuency:MODE

<frequency>::=<NRf>[<units>]

where:

<NRf> is the frequency span.

<units>::=[Hz | kHz | MHz]

2-54 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Examples

SOURce1:FREQu

sets the CH 1 frequency span to 900 kHz.

[SOURce[1|2]]:FREQuency:STARt

This command sets or queries the start frequency of sweep for the speciﬁed channel. This command is always used with the [SOURce[1|2]]:FREQuency:STOP command. The setting range of start frequency depends on the waveform selected for sweep. For more information on the setting range, refer to the speciﬁcations page of Quick Start User Manual.

Group

Syntax

Related Commands

Arguments

Source

[SOURce[1|2]]:FREQuency:STARt {<frequency>|MINimum|MAXimum} [SOURce[1|2]]:FREQuency:STARt?

[SOURce[1|2]]:FREQuency:MODE [SOURce[1|2]]:FREQuency:STOP

<frequency>::=<NRf>[<units>]

ency:SPAN 900 kHz

where:

<NRf> is the start frequency.

<units>::=[Hz | kHz | MHz]

Returns

Examples

SOURce1:FREQuency:STARt 10kHz

sets the sweep start frequency of CH 1 to 10 kHz.

[SOURce[1|2]]:FREQuency:STOP

This command sets or queries the start frequency of sweep for the speciﬁed channel. This command is always used with the [SOURce[1|2]]:FREQuency:STARt command. The setting range of stop frequency depends on the waveform selected for sweep. For more information on the setting range, refer to the AFG3000 Series Speciﬁcations and Performance Veriﬁcation Technical Reference, which can be found on the Tektronix Web site (www.tektronix.com/downloads).

Group

Source

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-55

Command Descriptions

Syntax

Related Commands

Arguments

Returns

Examples

[SOURce[1|2]] [SOURce[1|2]]:FREQuency:STOP?

[SOURce[1|2]]:FREQuency:MODE, [SOURce[1|2]]:FREQuency:STARt

<frequency>::=<NRf>[<units>]

where:

<NRf> is the stop frequency.

<units>::=[Hz | kHz | MHz]

SOURce1:FREQuency:STOP 100KHz 100KHz

sets the stop frequency of CH 1 to 100 kHz.

[SOURce[1|2]]:FSKey[:FREQuency]

:FREQuency:STOP

{<frequency>|MINimum|MAXimum}

Group

Syntax

Arguments

Returns

Examples

This command sets or queries the hop frequency of FS speciﬁed channel.

Source

[SOURce[1|2]]:FSKey[:FREQuency] {<frequency>|MINimum|MAXimum} [SOURce[1|2]]:FSKey[:FREQuency]?

<frequency>::=<NRf>[<units>]

where:

<NRf> i s the hop frequency.

<units>::=[Hz | kHz | MHz]

SOURce1:FSKey:FREQuency 1.0MHz

sets the hop frequency of CH 1 FSK modulation to 1.0 MHz.

K modulation for the

2-56 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

[SOURce[1|2]

Arguments

]:FSKey:INTernal:RATE

This command sets or queries the internal m odulation rate of FSK modulation for the speciﬁed channel. You can use this command only when the internal

ource is selected.

Group

Syntax

Returns

modulation s

Source

[SOURce[1|2]]:FSKey:INTernal:RAT E {<rate>|MINimum|MAXimum} [SOURce[1|2]]:FSKey:INTernal:RAT E?

<rate>::=<NRf>[<units>]

where:

<NRf> is the modulation rate.

<units>::=[Hz | kHz | MHz]

<rate>

Examples

SOURce1:FSKey:INTernal:RATE 50Hz

sets the C H 1 internal modulation rate to 50 Hz.

[SOURce[1|2]]:FSKey:SOURce

This command sets or queries the source of modulation signal of FSK modulation for the speciﬁed channel.

Group

Syntax

Arguments

Returns

Source

[SOURce[1|2]]:FSKey:SOURce [INTernal|EXTernal] [SOURce[1|2]]:FSKey:SOURce?

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

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-57

Command Descriptions

Examples

SOURce1:FSKey

sets the CH 1 source of modulating signal to internal.

[SOURce[1|2]]:FSKey:STATe

This command enables or disables FSK modulation. The query command returns the state of FSK m o dulation. You can select a sine, square, ramp, or arbitrary waveform for the carrier waveform.

Group

Syntax

Arguments

Returns

Source

[SOURce[1|2]]:FSKey:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:FSKey:STATe?

ON or <NR1>≠0 enables FSK modulation.

OFF or <NR1>=0 disables FSK modulation.

<NR1>

:SOURce INTerna l

Examples

SOURce1:FSKey:STATe ON

s the CH 1 FSK modulation.

enable

[SOURce[1|2]]:FUNCtion:EFILe

This command sets or queries an EFILe name used as an output waveform. A ﬁle name must be speciﬁed in the mas if there is no ﬁle in the mass storage.

Group

Syntax

Arguments

Returns

Source

[SOURce[1|2]]:FUNCtion:EFILe <file_name> [SOURce[1|2]]:FUNCtion:EFILe?

<ﬁle_name>::=<string> speciﬁes a ﬁle name in the mass storage system. The <ﬁle_name> includes path. Path separators are forward slashes (/).

<file_name>

s storage system. This command returns “ ”

2-58 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Examples

SOURce1:FUNCt

sets a ﬁle named “SAMPLE1” in the mass storage.

ion:EFILe “SAMPL E1”

[SOURce[1|2]]:FUNCtion:RAMP:SYMMetry

This command sets or queries the symmetry of ramp waveform for the speciﬁed channel. The setting range is 0.0% to 100.0%.

Group

Syntax

Arguments

Source

[SOURce[1|2]]:FUNCtion:RAMP:SYMM etr y

{<symmetry>|MINimum|MAXimum}

[SOURce[1|2]]:FUNCtion:RAMP:SYMM etr y?

<symmetry>::=<NR2>[<units>]

where:

<NR2> is the symmetry.

<units>::=PCT

Returns

Examples

SOURce1:FUNCtion:RAMP:SYMMetry 80.5 sets the symmetry of the CH

1 ramp waveform to 80.5%.

[SOURce[1|2]]:FUNCtion[:SHAPe]

This command sets or queries the shape of the output waveform. When the speciﬁed user memory is deleted, this commandcausesanerrorifyouselect the user memory.

Group

Syntax

Source

[SOURce[1|2]]:FUNCtion[:SHAPe] {SINusoid|SQUare|PULSe|RAMP

|PRNoise|DC|SINC|GAUSsian|LORentz|ERISe|EDECay| HAVersine|USER[1]|USER2|USER3|USER4|EMEMory[1]|EMEMory2|EFILe}

[SOURce[1|2]]:FUNCtion[:SHAPe]?

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-59

Command Descriptions

Arguments

SINusoid|SQUa

LORentz|ERISe|EDECay|HAVersine

The following table shows the combination of modulation type and the shape of output waveform.

Sine, Square, Ramp, Arb, Sin(x)/x, Gaussian, Lorentz, Exponential Rise, Exponential Decay, Haversine Pulse Noise, DC

FSK

PWM

Sweep

Burst

√ √ √ √

√ √ √√

If you select a waveform shape that is not allowed with a particular modulation, sweep, or burst, the Run mode will automatically be changed to Continuous.

If you specify EFILe when there is no EFILe or the EFILe is not yet deﬁned, 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.

Auserdeﬁned waveform saved in the user waveform memory or the EMEMory can be selected as an output waveform.

EFILe EFILe is speciﬁed as an output waveform.

Returns

Examples

SOURce1:FUNCtion:SHAPe SQUare

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 speciﬁed channel. You can set the value in radians or degrees. If no units are speciﬁed, the default is RAD. The query command returns the value in RAD.

2-60 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Group

Syntax

Arguments

Returns

This command is and Pulse.

Source

[SOURce[1|2]]:PHASe[:ADJust] {<phase>|MINimum|MAXimum} [SOURce[1|2]]:PHASe[:ADJust]?

<phase>::=<NR3>[<units>]

where:

<NR3> is the phase of output frequency.

<units>::=[RAD | DEG]

If <units> are omitted, RAD is speciﬁed automatically. The setting ranges are:

RAD: -1 PI to +1 PI, relative to phase value

DEG: -180 to +180, relative to phase value

<phase>

supported when you select a waveform other than DC, Noise,

Examples

SOURce1:PHASe:ADJust MAXimum sets the maximum value for the phase of

CH 1 output frequency.

[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. If your arbitrary function generator is single-channel model, this command is not supported.

Group

Syntax

Arguments

Examples

Source

[SOURce[1|2]]:PHASe:INITiate

None

[SOURCE[1|2]]:PHASE:INITIATE synchronizes the

2 o utput si gnals.

phase of CH 1 and CH

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-61

Command Descriptions

[SOURce[1|2]

Arguments

]:PM[:DEViation]

This command sets or queries the peak frequency deviation of PM modulation for the speciﬁed channel.

Group

Syntax

Source

[SOURce[1|2]]:PM[:DEViation] {<deviation>|MINimum|MAXimum} [SOURce[1|2]]:PM[:DEViation]?

<deviation>::=<NR3>[<units>]

where:

<NR3> is the phase deviation.

<units>::=[RAD | DEG]

If <units> are omitted, RAD is speciﬁed automatically. The setti

RAD:0PIto+1PI,relativetophasevalue

DEG: 0 to +180, in 1 degree steps, relative to phase value

ng ranges are:

Returns

Examples

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 speciﬁed channel. You can use this command only when the internal modulation source is selected.

You can set the internal modulation frequency from 2 mHz to 50.00 kHz with resolution of 1 mHz.

You can select the source of modulating signal by using the [SOURce[1|2]]:PM:SOURce [INTernal|EXTernal] command.

Group

Source

2-62 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Syntax

Related Comma

Arguments

nds

[SOURce[1|2]]

{<frequency>|MINimum|MAXimum}

[SOURce[1|2]]:PM:INTernal:FREQue ncy ?

[SOURce[1|2]]:PM:SOURce

<frequency>::=<NRf>[<units>]

:PM:INTernal:FREQuency

where:

<NRf> is the modulation frequency.

<units>::=[Hz | kHz | MHz]

Returns

Examples

SOURce1:PM:INTernal:FREQuency 10kHz

sets the CH 1 internal modulation frequency to 10 kHz.

[SOURce[1|2]]:PM:INTernal:FUNCtion

Group

Syntax

Related Commands

Arguments

This command sets or queries the modulating waveform of PM modulation for the speciﬁed channel. You can use this command only when the internal modulation source is selected.

Source

[SOURce[1|2]]:PM:INTernal:FUNCti on

{SINusoid|SQUare|TRIangle| RAMP|NRAMp|PRNoise| USER[1]|USER2|USER3|USER4|EMEMory[1]|EMEMory2|EFILe}

[SOURce[1|2]]:PM:INTernal:FUNCti on?

[SOURce[1|2]]:PM:SOURce

One of six types of function waveform can be selected as a modulating signal.

Auserdeﬁned waveform saved in the user w aveform memory or the EMEMory can be selected as a modulating signal.

EFILe EFILe

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-63

Command Descriptions

lating signal.

Returns

Examples

is used as a modu

SOURce1:PM:INTernal:FUNCtion SQUare

selects Square as the shape of modulating waveform for the CH 1 output.

[SOURce[1|2]]:PM:INTe rnal:FUNCtion:EFILe

This command sets or queries an EFILe name used as a modulating waveform for PM modulation. A ﬁle name must be speciﬁed in the mass storage system. This command returns “ ” if there is no ﬁle in the mass storage.

Group

Syntax

Source

[SOURce[1|2]]:PM:INTernal:FUNCti on: EFI Le <file_name> [SOURce[1|2]]:PM:INTernal:FUNCti on: EFI Le?

Arguments

Returns

Examples

<ﬁle_name>::=<string> speciﬁes a ﬁle name in the mass storage system. The <ﬁle_name> includes path. Path separators are forward slashes (/).

<file_name>

SOURce1:PM:INTernal:FUNCtion:EFI Le “SAMPLE1”

sets a ﬁle named “SAMPLE1” in the mass storage.

[SOURce[1|2]]:PM:SOURce

This command sets or queries the source of modulation signal of PM modulation for the speciﬁed channel.

Group

Syntax

Source

[SOURce[1|2]]:PM:SOURce [INTernal|EXTernal] [SOURce[1|2]]:PM:SOURce?

2-64 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Arguments

Returns

Examples

INTernal means

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.

[SOURce[1|2]]:PM:STATe

This command enables or disables PM modulation. The query command returns the state of PM modulation. You can select a sine, square, ramp, or arbitrary waveform for the carrier waveform.

Group

Syntax

Source

[SOURce[1|2]]:PM:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:PM:STATe?

that the carrier waveform is modulated with an internal source.

Arguments

Returns

Examples

ON or <NR1>≠0 enables PM modulation.

OFF or < NR1>=0 disables PM modulation.

<NR1>

SOURce1:PM:STATe ON

enables the CH 1 PM modulation.

SOURce<3|4>:POWer[:LEVel][:IMMediate][:AMPLitude]

This command sets or queries the internal noise level which applies to the output signal for the speciﬁed channel. The noise level represents the percent against current amplitude level. The setting range is 0 to 50%.

This command is available when Run Mode is set to Continuous, Burst, or Sweep.

You can set or query whether to add the internal noise to the output signal using the [SOURce[1|2]]:COMBine:FEED command.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-65

Command Descriptions

Group

Syntax

Related Commands

Arguments

Returns

Examples

Source

SOURce<3|4>:POWer[:LEVel][:IMMed iat e][ :AM PLi tud e]

{<percent>|MINimum|MAXimum}

SOURce<3|4>:POWer[:LEVel][:IMMed iat e][ :AM PLi tud e]?

[SOURce[1|2]]:COMBine:FEED

<percent>::=<NR2>[<units>]

where:

<NR2> is the noise level.

<units>::=PCT

SOURce3:POWer:LEVel:IMMediate:AM PLi tud e 50PCT

sets the internal noise level that is adde d to the output signal to 50%.

[SOURce[1|2]]:PULSe:DCYCle

This command sets or queries the duty cycle of the pulse waveform for the speciﬁed channel. The setting range is 0.001% to 99.999% in increments of 0.001.

The arbitrary function generator will hold the settings of leading edge and trailing edge when the duty cycle is varied.

Refer to the [SOURce[1|2]]:PULSe:WIDTh command for the setting range.

Group

Syntax

Related Commands

Arguments

Source

[SOURce[1|2]]:PULSe:DCYCle {<percent>|MINimum|MAXimum} [SOURce[1|2]]:PULSe:DCYCle?

[SOURce[1|2]]:PULSe:WIDTh

<percent>::=<NR2>[<units>]

where:

<NR2> is the duty cycle.

2-66 AFG3000 Series Arbitrary Function Generator Programmer Manual

<units>::=PCT

Command Descriptions

Returns

Examples

SOURce1:PULSe:DCYCle 80.5

sets the duty cycle of the pulse waveform on CH 1 to 80.5%.

[SOURce[1|2]]:PULSe:DELay

This command sets or queries the lead delay of the pulse waveform for the speciﬁed channel.

Group

Syntax

Related Commands

Source

[SOURce[1|2]]:PULSe:DELay {<delay>|MINimum| [SOURce[1|2]]:PULSe:DELay?

MAXimum}

Arguments

Returns

Examples

<delay>::=<NR2>[<units>]

where:

<NR2> is the lead delay.

<units>::=[ns | μs|ms|s]

Setting range:

0 ns to Pulse Period (Continuous mode)

0 ns to Pulse Period - {Pulse Width + 0.8 ∞ (Leading Edge Time + Trailing Edge Time)} (Triggered/Gated burst mode)

<delay>

SOURce1:PULSe:DELay 20ms

sets the CH 1 lead delay to 20 ms.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-67

Command Descriptions

[SOURce[1|2]

Arguments

]:PULSe:HOLD

The [SOURce[1|2] ]:P ULS e:H OLD command sets the arbitrary function generator to hold either pulse width or pulse duty.

The

Group

Syntax

Returns

Examples

Source

[SOURce[1|2]]:PULSe:HOLD {WIDTh|DUTY} [SOURce[1|2]]:PULSe:HOLD?

WIDTh means that the arbitrary function generator holds the pulse width setting.

DUTY means that the arbitrary function generator holds the pulse duty setting.

WIDT|DUTY

SOURce1:PULSe:HOLD WIDTh

[SOURce[1|2]]:PULSe:HOLD? query returns WIDTh or DUTY.

holds the CH 1 pulse width setting.

[SOURce[1|2]]:PULSe:PERiod

This command s ets or queries the period for pulse waveform.

Group

Syntax

Arguments

Source

[SOURce[1|2]]:PULSe:PERiod {<period>|MINimum|MAXimum} [SOURce[1|2]]:PULSe:PERiod?

<period>::=<NRf>[<units>]

where:

<NRf> is the pulse period.

<units>::=[ns | μs|ms|s]

Returns

2-68 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Examples

SOURce1:PULSe

sets the CH 1 pulse period to 200 ns.

:PERiod 200ns

[SOURce[1|2]]:PULSe:TRANsition[:LEADing]

This command sets or queries the leading edge time of pulse waveform.

Group

Syntax

Arguments

Source

[SOURce[1|2]]:PULSe:TRANsition[: LEA Din g] {<seconds>|MINimum|

MAXimum}

[SOURce[1|2]]:PULSe:TRANsition[: LEA Din g]?

<seconds>::=<NRf>[<units>]

where:

<NRf> is the leading edge time of pulse waveform.

<units>::=[ns | μs|ms|s]

Returns

Examples

SOURce1:PULSe:TRANsition:LEADing 200ns

sets the CH 1 leading edge time to 200 ns.

[SOURce[1|2]]:PULSe:TRANsition:TRAiling

This command sets or queries the trailing edge time of pulse waveform.

Group

Syntax

Arguments

Source

[SOURce[1|2]]:PULSe:TRANsition:T RAi lin g {<seconds>|MINimum|

MAXimum}

[SOURce[1|2]]:PULSe:TRANsition:T RAi lin g?

<seconds>::=<NRf>[<units>]

where:

<NRf> is the trailing edge of pulse waveform.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-69

Command Descriptions

<units>::=[ns

Returns

Examples

SOURce1:PULSe:TRANsition:TRAilin g 200ns

sets the trailing edge time to 200 ns.

[SOURce[1|2]]:PULSe:WIDTh

This command sets or queries the pulse width for the speciﬁed channel.

Pulse Width = Period ∞ Duty Cycle / 100

The pulse width must be less than the period. The setting range is 0.001% to

99.999% in terms of duty cycle.

AFG3011 / 3011C: 80 ns to 999.99 s

AFG3021B / 3021C / 3022B / 3022C: 16 ns to 999.99 s

AFG3051C / 3052C: 12 ns to 999.99 s

| μs|ms|s]

Group

Syntax

Related Commands

Arguments

AFG3101 / 3101C / 3102 / 3102C: 8 ns to 999.99 s

AFG3151C / 3152C: 5 ns to 999.99 s

AFG3251 / 3251C / 3252 / 3252C: 4 ns to 999.99 s

Pulse Width ≤ Pulse Period - 0.8 ∞ (Leading Edge Time + Trailing Edge Time)

Pulse Width ≥ 0.625 ∞ (Leading Edge Time + Trailing Edge Time)

Source

[SOURce[1|2]]:PULSe:WIDTh {<seconds>|MINimum|MAXimum} [SOURce[1|2]]:PULSe:WIDTh?

[SOURce[1|2]]:PULSe:DCYCle

<seconds>::=<NRf>[<units>]

where:

<NRf> is the pulse width.

<units>::=[ns | μs|ms|s]

2-70 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Returns

Examples

SOURce1:PULSe:WIDTh 200ns

sets the CH 1 pulse width to 200 ns.

[SOURce[1|2]]:PWM:INTernal:FREQuency

This command sets or queries the internal modulation frequency of PWM modulation for the speciﬁed channel. You can use this command only when the internal modulation source is selected.

You can set the internal modulation frequency from 2 mHz to 50.00 kHz with resolution of 1 mHz.

You can select the source of modulating signal by using the [SOURce[1|2]]:PWM:SOURce [INTernal|EXTernal] command.

Group

Syntax

Source

[SOURce[1|2]]:PWM:INTernal:FREQu enc y

{<frequency>|MINimum|MAXimum}

[SOURce[1|2]]:PWM:INTernal:FREQu enc y?

Related Commands

Arguments

Returns

Examples

[SOURce[1|2]]:PWM:SOURce

<frequency>::=<NRf>[<units>]

where <NRf> is the modulation frequency.

<units>::=[Hz | kHz | MHz]

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 speciﬁed channel. You can use this command only when the internal modulation source is selected.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-71

Command Descriptions

Group

Syntax

Related Commands

Arguments

If you specify E this command causes an error.

Source

[SOURce[1|2]]:PWM:INTernal:FUNCt ion {SINusoid|SQUare|TRIangle

|RAMP|NRAMp|PRNoise|USER[1]|USER2|USER3|USER4|EMEMory[1]|EMEMory2|EFILe}

[SOURce[1|2]]:PWM:INTernal:FUNCt ion ?

[SOURce[1|2]]:PWM:SOURce

One of six types of function waveform can be selected as a modulating signal.

USER[1]|USER2|

Auserdeﬁned waveform saved in the user waveform memory or the EMEMory can be selected as a mo dulating signal.

EFILe

EFILe is used as a m odulating signal.

FILe when there is no EFILe or the EFILe is not yet deﬁned,

USER3|USER4|EMEMory[1]|EMEMory2

Returns

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 ﬁle name must be speciﬁed in the mass storage system. This command returns “ ” if there is no ﬁle in the mass storage.

Group

Syntax

Arguments

Source

[SOURce[1|2]]:PWM:INTernal:FUNCt ion :EF ILe <file_name> [SOURce[1|2]]:PWM:INTernal:FUNCt ion :EF ILe ?

<ﬁle_name>::=<string> speciﬁes a ﬁle name in the mass storage system. The <ﬁle_name> includes path. Path separators are forward slashes (/).

2-72 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Returns

Examples

<file_name>

SOURce1:PWM:INTernal:FUNCtion:EF ILe “SAMPLE1”

creates a ﬁle named “SAMPLE1” in the m ass storage.

[SOURce[1|2]]:PWM:SOURce

This command sets o r queries the source of modulating signal of PWM modulation for the speciﬁed channel.

Group

Syntax

Arguments

Source

[SOURce[1|2]]:PWM:SOURce [INTernal|EXTernal] [SOURce[1|2]]:PWM:SOURce?

INTernal means that the carrier waveform is modulated with the internal source.

EXTernal means that the carrier waveform is modulated with an external source.

Returns

Examples

INT|EXT

SOURce1:PWM:SOURce INTernal

sets the source of modulating signal on CH 1 to internal.

[SOURce[1|2]]:PWM:STATe

This comman d enables or disables PWM modulatio n. The que ry command returns the state of PWM modulation. You can selec carrier waveform for PWM.

Group

Syntax

Arguments

Source

[SOURce[1|2]]:PWM:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:PWM:STATe?

ON or <NR1>≠0 enables PWM modulation.

OFF or <NR1>=0 disables PWM modulation.

t only pulse waveform as a

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-73

Command Descriptions

Returns

Examples

<NR1>

SOURce1:PWM:STATe ON

enables the CH 1 PWM modulation.

[SOURce[1|2]]:PWM[:DEViation]:DCYCle

This command sets or queries the PWM deviation in percent for the speciﬁed channel.

The setting range must meet the following conditions:

Deviation ≤ Pulse Width - PWmin

Deviation ≤ Pulse Period - Pulse Width - PWmin

Deviation ≤ Pulse Width - 0.8 × (Leading Edge Time + Trailing Edge Time)

Deviation ≤ Pulse Period - Pulse Width - 0.8 × (Leading Edge Time + Trailing Edge Time)

where PWmin is the minimum pulse width.

Group

Syntax

Arguments

Returns

Examples

Source

[SOURce[1|2]]:PWM[:DEViation]:DC YCl e

{<percent>|MINimum|MAXimum}

[SOURce[1|2]]:PWM[:DEViation]:D

<percent>::=<NR2>[<units>]

where:

<NR2> is the PWM deviation.

<units>::=PCT

SOURce1:PW

sets the CH 1 PWM deviation to 5.0% .

M[:DEViation]:DCYCle 5.0

CYCle?

2-74 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

[SOURce]:ROS

Arguments

Examples

Cillator:SOURce

This command sets the reference clock to either internal or external.

Group

Syntax

Returns

Source

[SOURce]:ROSCillator:SOURce {INTernal|EXTernal} [SOURce]:ROSCillator:SOURce?

INTernal means that the reference clock is set to internal.

EXTernal means that the reference clock is set to external.

INT|EXT

SOURce:ROSCillator:SOURce INTernal

selects the internal clock reference.

[SOURce[1|2]]:SWEep:HTIMe

This command sets or queries the sweep hold time. Hold time represents the amount of time that the frequency must remain stable after reaching the stop frequency.

Group

Syntax

Arguments

Returns

Source

[SOURce[1|2]]:SWEep:HTIMe {<seconds>|MINimum|MAXimum} [SOURce[1|2]]:SWEep:HTIMe?

<seconds>::=<NRf>[<units>]

where:

<NRf> is the hold time in seconds.

<units>::=[ns | μs|ms|s]

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-75

Command Descriptions

Examples

SOURce1:SWEep

sets the CH 1 hold time to 1 ms.

[SOURce[1|2]]:SWEep:MODE

The [SOURce[1|2]]:SWEep:M ODE command selects auto or ma nual for the sweep m ode for the speciﬁed channel.

The query command returns the sweep mode for the speciﬁed channel.

Group

Syntax

Related Commands

Source

[SOURce[1|2]]:SWEep:MODE {AUTO|MANual} [SOURce[1|2]]:SWEep:MODE?

[SOURce[1|2]]:SWEep:HTIMe

[SOURce[1|2]]:SWEep:RTIMe

[SOURce[1|2]]:SWEep:TIME

:HTIMe 1ms

TRIGger[:SEQuence]:SOURce

TRIGger[:SEQuence]:TIMer

Arguments

Returns

Examples

AUTO sets the sweep m ode to auto. The instrument outputs a continuous sweep at a rate speciﬁed by Sweep Time, Hold Time, and Return Time.

MANual sets the sweep mode to manual. The instrument outputs one sweep when a trigger input is received.

AUTO|MAN

SOURce1:SWEep:MODE AUTO

sets the CH1 swe ep mode to auto. The instrument outputs a continuous sweep.

[SOURce[1|2]]:SWEep:RTIMe

This command sets or queries the sweep return time. Return time represents the amount of time from s not include hold time.

top frequency through start frequency. Return time does

2-76 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Group

Syntax

Arguments

Returns

Examples

Source

[SOURce[1|2]]:SWEep:RTIMe {<seconds>|MINimum|MAXimum} [SOURce[1|2]]:SWEep:RTIMe?

<seconds>::=<NRf>[<units>]

where:

<NRf> is the return time in seconds.

<units>::=[ns | μs|ms|s]

SOURce1:SWEep:RTIMe 1ms

sets the CH 1 return time to 1 ms.

[SOURce[1|2]]:SWEep:SPACing

Group

Syntax

Arguments

Returns

Examples

The [SOURce[1|2]]:SWEep:SPACing command selects linear or logarithmic spacing for the sweep for the speciﬁed channel.

The query command returns the type for the sweep spacing for the speciﬁed channel.

Source

[SOURce[1|2]]:SWEep:SPACing {LINear|LOGarithmic} [SOURce[1|2]]:SWEep:SPACing?

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.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-77

Command Descriptions

[SOURce[1|2]

Arguments

]:SWEep:TIME

This command sets or queries the sweep time for the sweep for the speciﬁed channel. The sweep time does not include hold time and return time. The setting range is 1 ms t

Group

Syntax

Returns

Source

[SOURce[1|2]]:SWEep:TIME {<seconds>|MINimum|MAXimum} [SOURce[1|2]]:SWEep:TIME?

<seconds>::=<NRf>[<units>]

where:

<NRf> is the sweep time in seconds.

<units>::=[ns | μs|ms|s]

o300s.

Examples

SOURce1:SWEep:TIME 100ms

sets the CH 1 sweep time to 100 ms.

[SOURce[1|2]]:VOLTage:CONCurrent[:STATe]

This command enables or disables the function to copy the voltage level of one channel to another channel.

The[SOURce[1|2]]:VOLTage:CONCurrent[:STATe] command copies the voltage level of the channel speciﬁed by the header sufﬁx to another channel. If you specify CH 1 with the header, the CH 1 voltage level will be copied to CH 2.

The query command returns “0” (off) or “1” (on).

If your arbitrary function generator is a single-channel model, this command is not supported.

Group

Syntax

Source

[SOURce[1|2]]:VOLTage:CONCurrent [:S TAT e] {ON|OFF|<NR1>} [SOURce[1|2]]:VOLTage:CONCurrent [:S TAT e]?

2-78 AFG3000 Series Arbitrary Function Generator Programmer Manual

Command Descriptions

Arguments

Returns

Examples

ON or <NR1>≠0en

OFF or <NR1>=0 disables the concurrent copy function.

<NR1>

SOURce1:VOLTage:CONCurrent:STATe ON

enables the concurrent copy function.

[SOURce[1|2]]:VOLTage[:LEV

This command sets or queries the high level of output amplitude for the speciﬁed channel. If your instrument is a dual-channel model and the

[SOURce[1|2]]:VOLTage:CON

then the high level of other channel is also the same value.

Group

Source

ables the concurrent copy function.

el][:IMMediate]:HIGH

Current[:STATe]

command is set to ON,

Syntax

Related Commands

Arguments

Returns

Examples

[SOURce[1|2]]:VOLTage[:LEVel][:I MMe dia te] :HIG H

{<voltage>|MINimum|MAXimum}

[SOURce[1|2]]:VOLTage[:LEVel][:I MMe dia te] :HIG H?

[SOURce[1|2]]:VOLTage:CONCurrent[:STATe]

<voltage>::=<NRf>[<units>]

where:

<NRf> is the high level of output amplitude.

<units>::=[mV | V]

SOURce1:VOLTage:LEVel:IMMediate: HIG H 1V

sets the high level of CH 1 output amplitude to 1 V.

AFG3000 Series Arbitrary Function Generator Programmer Manual 2-79

Command Descriptions

[SOURce[1|2]

Related Commands

Arguments

]:VOLTage[:LEVel][:IMMediate]:LOW

This command sets or queries the low level of output amplitude for the speciﬁed channel. If your instrument is a dual-channel model and the

]]:VOLTage:CONCurrent[:STATe]

Group

Syntax

[SOURce[1|2

then the low level of other channel is also the same value.

Source

[SOURce[1|2]]:VOLTage[:LEVel][:I MMe dia te] :LO W

{<voltage>|MINimum| MAXimum}

[SOURce[1|2]]:VOLTage[:LEVel][:I MMe dia te] :LO W?

[SOURce[1|2]]:VOLTage:CONCurrent[:STATe]

<voltage>::=<NRf>[<units>]

where:

<NRf> is the low level of output amplitude.

command is set to ON,

<units>::=[mV | V]

Returns

Examples

SOURce1:VOLTage:LEVel:IMMediate: LOW -1V

sets the low level of CH 1 output amplitude to -1 V.

[SOURce[1|2]]:VOLTage[:LEVel][:IMMediate]:OFFSet

This command sets or queries the offset level for the speciﬁed channel. If your instrument is a dual-channel model and the

[SOURce[1|2]]:VOLTage:CONCurrent [:S TAT e] command is set to ON,

then the offset level of the other channel is also the same value.

Group

Syntax

Source

[SOURce[1|2]]:VOLTage[:LEVel][:I MMe dia te] :OF FSe t

{<voltage>|MINimum|MAXimum}

[SOURce[1|2]]:VOLTage[:LEVel][:I MMe dia te] :OF FSe t?

2-80 AFG3000 Series Arbitrary Function Generator Programmer Manual

Tektronix AFG3102C, AFG3051C, AFG3251C, AFG3252C, AFG3101 Programmer Manual

Specifications and Main Features

Frequently Asked Questions

User Manual