No part of this manual may be
reproduced in any form or by any
means (including electronic storage
and retrieval or translation into a
foreign language) without prior
agreement and written consent from
Keysight Technologies, Inc. as
governed by United States and
international copyright laws.
Trademark Acknowledgments
Manual Part Number
N5180-90057
Edition
Edition 1, April 2016
Supersedes: September 2014
Printed in USA/Malaysia
Published by:
Keysight Technologies
1400 Fountaingrove Parkway
Santa Rosa, CA 95403
Warranty
THE MATERIAL CONTAINED IN THIS
DOCUMENT IS PROVIDED “AS IS,”
AND IS SUBJECT TO BEING
CHANGED, WITHOUT NOTICE, IN
FUTURE EDITIONS. FURTHER, TO
THE MAXIMUM EXTENT PERMITTED
BY APPLICABLE LAW, KEYSIGHT
DISCLAIMS ALL WARRANTIES,
EITHER EXPRESS OR IMPLIED WITH
REGARD TO THIS MANUAL AND
ANY INFORMATION CONTAINED
HEREIN, INCLUDING BUT NOT
LIMITED TO THE IMPLIED
WARRANTIES OF
MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE.
KEYSIGHT SHALL NOT BE LIABLE
FOR ERRORS OR FOR INCIDENTAL
OR CONSEQUENTIAL DAMAGES IN
CONNECTION WITH THE
FURNISHING, USE, OR
PERFORMANCE OF THIS
DOCUMENT OR ANY INFORMATION
CONTAINED HEREIN. SHOULD
KEYSIGHT AND THE USER HAVE A
SEPARATE WRITTEN AGREEMENT
WITH WARRANTY TERMS
COVERING THE MATERIAL IN THIS
DOCUMENT THAT CONFLICT WITH
THESE TERMS, THE WARRANTY
TERMS IN THE SEPARATE
AGREEMENT WILL CONTROL.
Technology Licenses
The hardware and/or software
described in this document are
furnished under a license and may be
used or copied only in accordance
with the terms of such license.
U.S. Government Rights
The Software is “commercial
computer software,” as defined
by Federal Acquisition Regulation
(“FAR”) 2.101. Pursuant to FAR
12.212 and 27.405-3 and
Department of Defense FAR
Supplement (“DFARS”) 227.7202,
the U.S. government acquires
commercial computer software
under the same terms by which
the software is customarily
provided to the public.
Accordingly, Keysight provides
the Software to U.S. government
customers under its standard
commercial license, which is
embodied in its End User License
Agreement (EULA) The license set
forth in the EULA represents the
exclusive authority by which the
U.S. government may use,
modify, distribute, or disclose the
Software. The EULA and the
license set forth therein, does not
require or permit, among other
things, that Keysight: (1) Furnish
technical information related to
commercial computer software or
commercial computer software
documentation that is not
customarily provided to the
public; or (2) Relinquish to, or
otherwise provide, the
government rights in excess of
these rights customarily provided
to the public to use, modify,
reproduce, release, perform,
display, or disclose commercial
computer software or commercial
computer software
documentation. No additional
government requirements
beyond those set forth in the
EULA shall apply, except to the
extent that those terms, rights, or
licenses are explicitly required
from all providers of commercial
computer software pursuant to
the FAR and the DFARS and are
set forth specifically in writing
elsewhere in the EULA. Keysight
shall be under no obligation to
update, revise or otherwise
modify the Software. With
respect to any technical data as
defined by FAR 2.101, pursuant
to FAR 12.211 and 27.404.2 and
DFARS 227.7102, the U.S.
government acquires no greater
than Limited Rights as defined in
FAR 27.401 or DFAR 227.7103-5
(c), as applicable in any technical
data.
Safety Notices
A CAUTION notice denotes a hazard. It
calls attention to an operating
procedure, practice, or the like that,
if not correctly performed or adhered
to, could result in damage to the
product or loss of important data. Do
not proceed beyond a CAUTION
notice until the indicated conditions
are fully understood and met.
A WARNING notice denotes a hazard.
It calls attention to an operating
procedure, practice, or the like that,
if not correctly performed or adhered
to, could result in personal injury or
death. Do not proceed beyond a
WARNING notice until the indicated
conditions are fully understood and
met.
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
27
Contents
28 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Documentation Overview
Getting Started Guide
User’s Guide
—Safety Information
—Receiving the Instrument
—Environmental & Electrical Requirements
—Basic Setup
—Accessories
—Operation Verification
—Regulatory Information
—Signal Generator Overview
—Setting Preferences & Enabling Options
—Basic Operation
—Optimizing Performance
—Using Analog Modulation (Option UNT)
—Using Pulse Modulation (Option UNW and 320)
—Basic Digital Operation – No BBG Option Installed
—Basic Digital Operation (Option 653/655/656/657)
—Adding Real–Time Noise to a Signal (Option 403)
—Real–Time Phase Noise Impairments (Option 432)
—Custom Digital Modulation (Option 431)
—Multitone and Two–Tone Waveform Generator (Option 430)
—Working in a Secure Environment
—Troubleshooting
Programming Guide
SCPI Reference
Programming
Compatibility Guide
—Getting Started with Remote Operation
—Using IO Interfaces
—Programming Examples
—Programming the Status Register System
—Creating and Downloading Files
—Creating and Downloading User–Data Files
—SCPI Basics
—Basic Function Commands
—LXI System Commands
—System Commands
—Analog Modulation Commands
—Arb Commands
—Real–Time Commands
—Provides a listing of SCPI commands and programming codes for
signal generator models that are supported by the Keysight EXG
and MXG X- Series signal generators.
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 29
Service Guide
—Troubleshooting
—Replaceable Parts
—Assembly Replacement
—Post–Repair Procedures
—Safety and Regulatory Information
—Instrument History
Key Help
a
—Key function description
—Related SCPI commands
a. Press the Help hardkey, and then the key for which you wish help.
30 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Keysight X-Series Signal Generators
N5171B/72B/73B EXG and N5181B/82B/83B MXG
SCPI Command Reference
1SCPI Basics
This chapter describes how SCPI information is organized and presented in this
guide. An overview of the SCPI language is also provided. This chapter
contains the following major sections:
— Command Reference Information on page 32
— SCPI Basics on page 33
31
SCPI Basics
Command Reference Information
Command Reference Information
SCPI Command Listings
The Table of Contents lists the Standard Commands for Programmable
Instruments (SCPI) without the parameters. The SCPI subsystem name will
generally have the first part of the command in parenthesis that is repeated in
all commands within the subsystem. The title(s) beneath the subsystem name
is the remaining command syntax. The following example demonstrates this
listing:
Communication Subsystem (:SYSTem:COMMunicate)
:LAN:IP
:LAN:SUBNet
The following examples show the complete commands from the above Table of
Contents listing:
The index is set up so applicable key and data field names can be
cross-referenced to the appropriate SCPI command. There are two headings in
the index where the key and data field names can be found:
— individual softkey, or data field name (i.e. To look up the communication
subsystem topic on Default Gateway softkey refer to Default Gateway
softkey.)
— subsystem name (i.e. To look for the Default Gateway softkey (in the
Communication Subsystem), refer to the heading labeled: “communication
subsystem keys”.)
Supported Field
Within each command section, the “Supported” heading describes which
signal generator configurations are supported by the SCPI command. When
“All Models” is shown next to this heading, all signal generator configurations
are supported by the SCPI command. When “All with Option xxx” is shown next
to this heading, only the stated option(s) is supported.
32 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
SCPI Basics
Common Terms
SCPI Basics
SCPI Basics
This section describes the general use of the SCPI language forKeysight
X-Series signal generators. It is not intended to teach you everything about the
SCPI language; the SCPI Consortium or IEEE can provide that level of detailed
information. For a list of the specific commands available for the signal
generator, refer to the table of contents.
For additional information, refer to the following publications:
— IEEE Standard 488.1-2003, IEEE Standard For Higher Performance Protocol
for the Standard Digital Interface for Programmable Instrumentation. New
York, NY, 2003.
— IEEE Standard 488.2-1992, IEEE Standard Codes, Formats, Protocols and
Command Commands for Use with ANSI/IEEE Standard 488.1-1987. New
York, NY, 1998.
The following terms are used throughout the remainder of this section:
Command A command is an instruction in SCPI consisting of
mnemonics (keywords), parameters (arguments), and
punctuation. You combine commands to form
messages that control instruments.
Controller A controller is any device used to control the signal
generator, for example a computer or another
instrument.
Event Command Some commands are events and cannot be queried. An
event has no corresponding setting; it initiates an action
at a particular time.
Program Message A program message is a combination of one or more
properly formatted commands. Program messages are
sent by the controller to the signal generator.
Query A query is a special type of command used to instruct
the signal generator to make response data available to
the controller. A query ends with a question mark.
Generally you can query any command value that you
set.
Response Message A response message is a collection of data in
specific SCPI formats sent from the signal generator to
the controller. Response messages tell the controller
about the internal state of the signal generator.
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 33
SCPI Basics
SCPI Basics
Command Syntax
A typical command is made up of keywords prefixed with colons (:). The
keywords are followed by parameters. The following is an example syntax
statement:
In the example above, the :INTernal:FREQuency portion of the command
immediately follows the :PULM portion with no separating space. The portion
following the :INTernal, <frequency>|MAXimum|MINimum|UP|DOWN, are
the parameters (argument for the command statement). There is a separating
space (white space) between the command and its parameter.
Additional conventions in syntax statements are shown in Table 1-1 and Table
1-2.
Table 1-1 Special Characters in Command Syntax
CharactersMeaningExample
|A vertical stroke between keywords or parameters
indicates alternative choices. For parameters, the
effect of the command varies depending on the choice.
[ ]Square brackets indicate that the enclosed keywords
or parameters are optional when composing the
command. These implied keywords or parameters will
be executed even if they are omitted.
< >Angle brackets around a word (or words) indicate they
are not to be used literally in the command. They
represent the needed item.
[:SOURce]:AM:
MOD DEEP|NORMal
DEEP or NORMal are the choices.
[:SOURce]:FREQuency[:CW
]?
SOURce and CW are optional items.
[:SOURce]:FREQuency:
STARt <value><unit>
In this command, the words
<value> and <unit> should be
replaced by the actual frequency
and unit.
:FREQuency:STARt 2.5GHz
34 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
Table 1-2 Command Syntax
Characters, Keywords, and SyntaxExample
Upper-case lettering indicates the minimum set of characters
required to execute the command. But, each mode of the
command must be in either short form or the complete long form
(no in-between). Example:
Correct:
:FREQ
:FREQuency
Incorrect:
:FREQuenc
Lower-case lettering indicates the portion of the command that is
optional; it can either be included with the upper-case portion of
the command or omitted. This is the flexible format principle called
forgiving listening. Refer to
Responses” on page 37
When a colon is placed between two command mnemonics, it
moves the current path down one level in the command tree. Refer
to
“Command Tree” on page 36 more information on
command paths.
If a command requires more than one parameter, you must
separate adjacent parameters using a comma. Parameters are not
part of the command path, so commas do not affect the path level.
“Command Parameters and
for more information.
[:SOURce]:FREQuency[:CW]?,
FREQ is the minimum requirement.
:FREQuency
Either :FREQ, :FREQuency, or
:FREQUENCY is correct.
:TRIGger:OUTPut:POLarity?
TRIGger is the root level keyword for this
command.
[:SOURce]:LIST:
DWELl <value>,<value>
A semicolon separates two commands in the same program
message without changing the current path.
White space characters, such as <tab> and <space>, are
generally ignored as long as they do not occur within or between
keywords.
However, you must use white space to separate the command
from the parameter, but this does not affect the current path.
:FREQ 2.5GHz;:POW 10dBm
:FREQ uency or :POWer :LEVel
are not allowed.
A <space> between :LEVel and 6.2
is mandatory.
:POWer:LEVel 6.2
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 35
SCPI Basics
SCPI Basics
Command Types
Commands can be separated into two groups: common commands and
subsystem commands. Figure 1-1, shows the separation of the two command
groups.
Common commands are used to manage status registers, synchronization, and
data storage and are defined by IEEE 488.2. They are easy to recognize
because they all begin with an asterisk. For example *IDN?, *OPC, and *RST
are common commands. Common commands are not part of any subsystem
and the signal generator interprets them in the same way, regardless of the
current path setting.
Subsystem commands are distinguished by the colon (:). The colon is used at
the beginning of a command statement and between keywords, as in
:FREQuency[:CW?]. Each command subsystem is a set of commands that
roughly correspond to a functional block inside the signal generator. For
example, the power subsystem (:POWer) contains commands for power
generation, while the status subsystem (:STATus) contains commands for
controlling status registers.
Figure 1-1 Command Types
Command Tree
Most programming tasks involve subsystem commands. SCPI uses a structure
for subsystem commands similar to the file systems on most computers. In
SCPI, this command structure is called a command tree and is shown in Figure
1-2.
36 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
Figure 1-2 Simplified Command Tree
The command closest to the top is the root command, or simply “the root.”
Notice that you must follow a particular path to reach lower level commands.
In the following example, :POWer represents AA, :ALC represents BB,
:SOURce represents GG. The complete command path is
:POWer:ALC:SOURce? (:AA:BB:GG).
Paths Through the Command Tree
To access commands from different paths in the command tree, you must
understand how the signal generator interprets commands. The parser, a part
of the signal generator firmware, decodes each message sent to the signal
generator. The parser breaks up the message into component commands
using a set of rules to determine the command tree path used. The parser
keeps track of the current path (the level in the command tree) and where it
expects to find the next command statement. This is important because the
same keyword may appear in different paths. The particular path is determined
by the keyword(s) in the command statement.
A message terminator, such as a <new line> character, sets the current path
to the root. Many programming languages have output statements that
automatically send message terminators.
The current path is set to the root after the line-power is cycled or when
*RST is sent.
Command Parameters and Responses
SCPI defines different data formats for use in program and response messages.
It does this to accommodate the principle of forgiving listening and precise
talking. For more information on program data types refer to IEEE 488.2.
Forgiving listening means the command and parameter formats are flexible.
For example, with the :FREQuency:REFerence:STATe ON|OFF|1|0
command, the signal generator accepts :FREQuency:REFerence:STATe ON,
:FREQuency:REFerence:STATe 1, :FREQ:REF:STAT ON,
:FREQ:REF:STAT 1 to turn on the frequency reference mode.
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 37
SCPI Basics
SCPI Basics
Each parameter type has one or more corresponding response data types. A
setting that you program using a numeric parameter returns either real or
integer response data when queried. Response data (data returned to the
controller) is more concise and restricted, and is called precise talking.
Precise talking means that the response format for a particular query is always
the same.
For example, if you query the power state (:POWer:ALC:STATe?) when it is
on, the response is always 1, regardless of whether you previously sent
:POWer:ALC:STATe 1 or :POWer:ALC:STATe ON. Table shows the response
for a given parameter type.
Parameter TypesResponse Data Types
NumericReal, Integer
Extended NumericReal, Integer
DiscreteDiscrete
BooleanNumeric Boolean
StringString
Definite Block
Arbitrary byte data
a
a. (i.e. text, binary, discrete, real, integer, etc.-).
Numeric Parameters
Numeric parameters are used in both common and subsystem commands.
They accept all commonly used decimal representations of numbers including
optional signs, decimal points, and scientific notation.
If a signal generator setting is programmed with a numeric parameter which
can only assume a finite value, it automatically rounds any entered parameter
which is greater or less than the finite value. For example, if a signal generator
has a programmable output impedance of 50 or 75 ohms, and you specified
76.1 for the output impedance, the value is rounded to 75. The following are
examples of numeric parameters:
100no decimal point required
100.fractional digits optional
−1.23leading signs allowed
4.56E<space>3space allowed after the E in exponential
−7.89E−001use either E or e in exponential
+256leading + allowed
.5digits left of decimal point optional
38 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
Extended Numeric Parameters
Most subsystems use extended numeric parameters to specify physical
quantities. Extended numeric parameters accept all numeric parameter values
and other special values as well.
The following are examples of extended numeric parameters:
100any simple numeric value
1.2GHzGHz can be used for exponential (E009)
200MHzMHz can be used for exponential (E006)
−100mVnegative 100 millivolts
10DEG10 degrees
Extended numeric parameters also include the following special
parameters:
DEFaultresets the parameter to its default value
UPincrements the parameter
DOWNdecrements the parameter
MINimumsets the parameter to the smallest possible value
MAXimumsets the parameter to the largest possible value
Discrete Parameters
Discrete parameters use mnemonics to represent each valid setting. They have
a long and a short form, just like command mnemonics. You can mix upper and
lower case letters for discrete parameters.
The following examples of discrete parameters are used with the command
:TRIGger[:SEQuence]:SOURce BUS|IMMediate|EXTernal.
BUSGPIB, LAN, or USB triggering
IMMediateimmediate trigger (free run)
EXTernalexternal triggering
Although discrete parameters look like command keywords, do not confuse the
two. In particular, be sure to use colons and spaces properly. Use a colon to
separate command mnemonics from each other and a space to separate
parameters from command mnemonics.
The following are examples of discrete parameters in commands:
TRIGger:SOURce BUS
TRIGger:SOURce IMMediate
TRIGger:SOURce EXTernal
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 39
SCPI Basics
SCPI Basics
Boolean Parameters
Boolean parameters represent a single binary condition that is either true or
false. The two-state boolean parameter has four arguments. The following list
shows the arguments for the two-state boolean parameter:
ONboolean true, upper/lower case allowed
OFFboolean false, upper/lower case allowed
1boolean true
0boolean false
String Parameters
String parameters allow ASCII strings to be sent as parameters. Single or
double quotes are used as delimiters.
The following are examples of string parameters:
'This is valid'
"This is also valid"
'SO IS THIS'
Real Response Data
Real response data represent decimal numbers in either fixed decimal or
scientific notation. Most high-level programming languages that support
signal generator input/output (I/O) handle either decimal or scientific notation
transparently.
The following are examples of real response data:
+4.000000E+010, −9.990000E+002
−9.990000E+002
+4.0000000000000E+010
+1
0
40 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
Integer Response Data
Integer response data are decimal representations of integer values including
optional signs. Most status register related queries return integer response
data.
The following are examples of integer response data:
0signs are optional
+100leading + allowed
−100leading − allowed
256never any decimal point
Discrete Response Data
Discrete response data are similar to discrete parameters. The main difference
is that discrete response data only returns the short form of a particular
mnemonic, in all upper case letters.
The following are examples of discrete response data:
IMM
EXT
INT
NEG
Numeric Boolean Response Data
Boolean response data returns a binary numeric value of one or zero.
String Response Data
String response data are similar to string parameters. The main difference is
that string response data returns double quotes, rather than single quotes.
Embedded double quotes may be present in string response data. Embedded
quotes appear as two adjacent double quotes with no characters between
them.
The following are examples of string response data:
"This is a string"
"one double quote inside brackets: [""]"
"Hello!"
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 41
SCPI Basics
SCPI Basics
Program Messages
The following commands will be used to demonstrate the creation of program
messages:
This program message is correct and will not cause errors; STARt and STOP are
at the same path level. It is equivalent to sending the following message:
FREQuency:STARt 500MHz;FREQuency:STOP 1000MHz
Example 2
:POWer 10DBM;:OFFSet 5DB
This program message will result in an error. The message makes use of the
default
POWer[:LEVel] node (root command). When using a default node, there is no
change to the current path position. Since there is no command OFFSet at the
root level, an error results.
The following example shows the correct syntax for this program message:
:POWer 10DBM;:POWer:OFFSet 5DB
Example 3
:POWer:OFFSet 5DB;POWer 10DBM
This program message results in a command error. The path is dropped one
level at each colon. The first half of the message drops the command path to
the lower level command OFFSet; POWer does not exist at this level.
The POWer 10DBM command is missing the leading colon and when sent, it
causes confusion because the signal generator cannot find POWer at the
POWer:OFFSet level. By adding the leading colon, the current path is reset to
the root. The following shows the correct program message:
:POWer:OFFSet 5DB;:POWer 10DBM
Example 4
FREQ 500MHz;POW 4DBM
In this example, the keyword short form is used. The program message is
correct because it utilizes the default nodes of :FREQ[:CW] and
:POW[:LEVel]. Since default nodes do not affect the current path, it is not
necessary to use a leading colon before FREQ or POW.
42 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
File Name Variables
File name variables designate a data file and file path. File name variables are
used in the SCPI command syntax whenever files are accessed. The name of
the file is always required, but the file path can sometimes be optional or be
designated using different formats. The following table shows these different
file path formats:
FormatFile Name VariableExample
Format 1"<file name>""Test_Data"
Format 2"<file name@msus>"
Format 3"<msus:file name>""SEQ:Test_Data"
Format 4"</user/directory/file name>""/USER/SEQ/Test_Data"
"Test_Data@SEQ"
a
a. Included for backwards compatibility. Not a recommended syntax.
Formats 2–4 offer programming flexibility and are equivalent. Format 1 can
only be used with SCPI commands that imply the path name as part of the
command syntax. Typically, SCPI load commands that access user-data files
do not need to have a file path designated.
See Table 1-3 on page 45 for information on file types and directories.
The maximum length for a file name is 23 characters, excluding the file
path.
Example Using Format 1
:CORR:FLAT:LOAD "FLAT_DATA"
The preceding example loads user-flatness data from a file called FLAT_DATA
located in the USERFLAT directory. No file path is needed as the command
syntax implies the directory where the file is located.
Example Using Format 2
:MEM:COPY "IQ_DATA@SNVWFM","Test_DATA@WFM1"
The preceding example copies a file named IQ_DATA located in the WAVEFORM
directory to a file named Test_DATA in volatile waveform memory (BBG).
Example Using Format 3
:MEM:COPY "SNVWFM:IQ_DATA","WFM1:Test_DATA"
The preceding example copies a file named IQ_DATA located in the WAVEFORM
directory to a file named Test_DATA in volatile waveform memory (BBG).
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 43
The preceding example copies a file named IQ_DATA located in the WAVEFORM
directory to a file named IQ_DATA in volatile waveform memory (BBG).
The following examples show commands, with different formats, that can be
used to download a waveform file named Test_Data into the signal generator’s
volatile waveform memory (BBG):
Command Syntax Format 3
:MEMory:DATA "WFM1:Test_Data",#ABC
Command Syntax Format 4
:MEMory:DATA "/USER/BBG1/WAVEFORM/Test_Data",#ABC
These commands are equivalent. The data block, #ABC, is described as
follows:
# This character indicates the beginning of the data block
A Number of digits in the byte count B
B Byte count in C
C Waveform data
Refer to “:DATA” on page 163 and the Programming Guide for more
information on data blocks and downloading waveform data.
File Types and Directory Structure
The signal generator uses a computer directory model structure for file
storage. The top level directory is called the USER directory. All other
directories are subdirectories located under the USER directory. Each
subdirectory is dedicated to the type of data stored. For example, the BIN
directory is used to store binary data whereas the MARKERS directory is used to
store marker data.
44 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
When the USB media is used, the files on the USB media are stored in a
single directory (i.e.
USER/). Each file has an extension (i.e. .waveform, .list,
.markers, .state, etc.-). The SCPI commands use the paths shown in Table
1-3 on page 45 and the associated examples. But when viewed, the USB
media, will not display these directories. Instead the file extensions will be
displayed. For more information on the USB media capability refer to the
Programming Guide and to the Users Guide.
The instrument’s directory /USER/NONVOLATILE contains either the
internal storage and USB media non-volatile files stored with the filename
extensions: .waveform, .list, .markers, .state, etc.-. This directory is useful
when ftp is used.
The following table lists signal generator the subdirectories and file paths
where file types are stored.
a. This feature does not apply to analog signal generator models.
MSUS (Mass Storage Unit Specifier) Variable
The variable "<msus>" enables a command to be file type specific when
working with user files. Some commands use it as the only command
parameter, while others can use it in conjunction with a file name when a
command is not file type specific. When used with a file name, it is similar to
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 45
SCPI Basics
SCPI Basics
Format 2 in the File Name Variables section on page 43. The difference is the
file type specifier (msus) occupies its own variable and is not part of the file
name syntax.
The following examples illustrate the usage of the variable "<msus>" when it is
the only command parameter:
Command Syntax with the msus variable
:MMEMory:CATalog? "<msus>"
Command Syntax with the file system
:MMEMory:CATalog? "LIST:"
The variable "<msus>" is replaced with "LIST:". When the command is
executed, the output displays only the files from the List file system.The
following examples illustrate the usage of the variable "<file name>" with the variable "<msus>":
Command Syntax with the file name and msus variables
:MMEMory:DELete[:NAME] "<file name>",["<msus>"]
Command Syntax with the file name and file system
:MMEMory:DELete:NAME "LIST_1","LIST:"
The command from the above example cannot discern which file system
LIST_1 belongs to without a file system specifier and will not work without it.
When the command is properly executed, LIST_1 is deleted from the List file
system.
The following example shows the same command, but using Format 2 from the
File Name Variables section on page 43:
:MMEMory:DELete:NAME "LIST_1@LIST"
When a file name is a parameter for a command that is not file system specific,
either format ("<file name>","<msus>" or "<file name@msus>") will work.
Refer to Table 1-3 on page 45 for a listing of the file systems and types.
Quote Usage with SCPI Commands
As a general rule, programming languages require that SCPI commands be
enclosed in double quotes as shown in the following example:
":FM:EXTernal:IMPedance 600"
However when a string is the parameter for a SCPI command, additional
quotes or other delimiters may be required to identify the string. Your
programming language may use two sets of doublequotes, one set of single
quotes, or back slashes with quotes to signify the string parameter. The
following examples illustrate these different formats:
46 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
"MEMory:LOAD:LIST ""myfile""" used in BASIC programming
languages
"MEMory:LOAD:LIST \"myfile\"" used in C, C++, Java, and PERL
"MEMory:LOAD:LIST 'myfile'" accepted by most programming
languages
Consult your programming language reference manual to determine the
correct format.
Binary, Decimal, Hexadecimal, and Octal Formats
Command values may be entered using a binary, decimal, hexadecimal, or
octal format. When the binary, hexadecimal, or octal format is used, their
values must be preceded with the proper identifier. The decimal format (default
format) requires no identifier and the signal generator assumes this format
when a numeric value is entered without one. The following list shows the
identifiers for the formats that require them:
— #B identifies the number as a binary numeric value (base-2).
— #H identifies the number as a hexadecimal alphanumeric value (base-16).
— #Q identifies the number as a octal alphanumeric value (base-8).
The following are examples of SCPI command values and identifiers for the
decimal value 45:
#B101101 binary equivalent
#H2D hexadecimal equivalent
#Q55 octal equivalent
The following example sets the RF output power to 10 dBm (or the equivalent
value for the currently selected power unit, such as DBUV or DBUVEMF) using
the hexadecimal value 000A:
:POW #H000A
A unit of measure, such as dBm or mV, will not work with the values when using
a format other than decimal.
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 47
SCPI Basics
SCPI Basics
48 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Keysight X-Series Signal Generators
N5171B/72B/73B EXG and N5181B/82B/83B MXG
SCPI Command Reference
2Basic Function Commands
This chapter provides SCPI descriptions for subsystems dedicated to signal
generator operations common to most MXG and EXG X-Series signal
generators.
This chapter contains the following major sections:
— Correction Subsystem ([:SOURce]:CORRection) on page 50
— Digital Modulation Subsystem—N5172B/82B ([:SOURce]) on page 56
— Frequency Subsystem ([:SOURce]) on page 70
— List/Sweep Subsystem ([:SOURce]) on page 83
— Marker Subsystem–N5173B/83B ([:SOURce]) on page 96
— Power Subsystem ([:SOURce]:POWer) on page 99
— Vector Modulation Subsystem—N5172B/82B ([:SOURce]:IQ) on page 118
49
Basic Function Commands
Correction Subsystem ([:SOURce]:CORRection)
Correction Subsystem ([:SOURce]:CORRection)
:FLATness:FREQuency
SupportedAll Models
[:SOURce]:CORRection:FLATness:FREQuency? <point>
This command returns the frequency value of the <point> queried.
Range 1 to 3,201
Key Entry # Points
:FLATness:INITialize:FSTep
SupportedAll Models
The current flatness data will be overwritten once this command is
executed. If needed, save the current data. Refer to the
command for storing user flatness files.
:FLATness:STORe
[:SOURce]:CORRection:FLATness:INITialize:FSTep
This command replaces the loaded user flatness data with the settings from
the current step array data points.
The maximum number of user flatness points is 3,201. When copying the step
array settings over to a user flatness file, ensure that the number of points in
the step array do not exceed the maximum user flatness points.
See also “:FLATness:STEP:POINts” on page 51.
Range 1 to 3,201
Key Entry Load Cal Array From Step Array
:FLATness:LOAD
SupportedAll Models
[:SOURce]:CORRection:FLATness:LOAD "<file name>"
This command loads a user–flatness correction file. The "<file name>" variable
is the name of the file located in the Catalog of USERFLAT Files. The directory
path is implied in the command and need not be specified in the file name
parameter. For more information on file name syntax, refer to “File Name
Variables” on page 43.
Key Entry Load From Selected File
50 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Correction Subsystem ([:SOURce]:CORRection)
This command sets a frequency and amplitude correction pair.
The maximum number of points that can be entered is 3,201.
<corr.> This variable is the power correction.
Range Frequency range varies and is model dependent. Refer
Key Entry Configure Cal Array
:FLATness:POINts
SupportedAll Models
to the instrument’s Data Sheet.
[:SOURce]:CORRection:FLATness:POINts?
This query returns the number of points in the user–flatness correction file.
:FLATness:PRESet
SupportedAll Models
The current correction data will be overwritten once this command is
executed. Save the current data if needed. Refer to
command for storing user–flatness files.
[:SOURce]:CORRection:FLATness:PRESet
This command presets the user–flatness correction to a factory–defined setting
that consists of one point.
This command sets the stop frequency for the user flatness calibration step
array. See also, :FLATness:STEP:POINts and :FLATness:STEP:STARt
commands.
*RST The preset value is model/option dependent. Refer to
Range The range is model/option dependent. Refer to the
Key Entry Freq Stop
:FLATness:STORe
SupportedAll Models
[:SOURce]:CORRection:FLATness:STORe "<file name>"
the instrument’s Data Sheet.
instrument’s Data Sheet.
This command stores the current user–flatness correction data to a file named
by the :CORRection:FLATness:STORe command. The directory path is
implied in the command and need not be specified in the "<file name>"
variable.
Key Entry Store To File
52 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Correction Subsystem ([:SOURce]:CORRection)
RemarksFor information on file name syntax, refer to “File Name
Variables” on page 43.
:PMETer:CHANnel
SupportedAll Models
[:SOURce]:CORRection:PMETer:CHANnel A|B
[:SOURce]:CORRection:PMETer:CHANnel?
This command selects the channel setting on the external power meter for user
flatness calibration.
Default Channel A
Key Entry Power Meter Channel A B
Remarks The setting enabled by this command is not affected by
This command enters a VXI–11 device name for a power meter that is being
controlled by the signal generator for user flatness calibration. If connecting
directly to the power meter, enter the name as specified on your power meter
documentation. If connecting through a LAN–GPIB gateway, enter the SICL
address of the power meter.
Key Entry PM VXI–11 Device Name
Remarks The setting enabled by this command is not affected by
This command sets the internet protocol (IP) address for a power meter that is
controlled by the signal generator for user flatness calibration. If connecting to
a GPIB power meter through a LAN–GPIB gateway, this command sets the IP
address of the gateway.
Key Entry Power Meter IP Address
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 53
Basic Function Commands
Correction Subsystem ([:SOURce]:CORRection)
RemarksThe setting enabled by this command is not affected by
signal generator power–on, preset, or *RST.
Ensure that the power meter IP address is different from
the signal generator address.
This command sets the IP port number on the power meter that is controlled
by the signal generator for users flatness calibration.
Key Entry Power Meter IP Port
5025Standard mode. The command enables standard mode
for simple programming.
5024Telnet mode. The command enables the telnet SCPI
service for programming.
For firmware versions <A.01.51, the default telnet mode is 5023. For
firmware versions A.01.51 and greater, telnet port 5023 is still available for
backwards compatibility.
RemarksThe setting enabled by this command is not affected by
signal generator power–on, preset, or *RST.
For more information on standard mode and telnet SCPI
mode, refer to the Programming Guide.
This command sets the attenuation level for the external I/Q signals being
modulated through the signal generator RF path. The variable <val> is
expressed in decibels (dB).
Example
:DM:EXT:INP:ATT 10
The preceding example sets the modulator attenuator to 10 dB.
56 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Digital Modulation Subsystem—N5172B/82B ([:SOURce])
This command enables or disables the external I/Q attenuator auto mode. The
auto mode will be switched to manual if the signal generator receives a AUTO
OFF or AUTO 0 command.
ON (1) This choice sets the external I/Q attenuator to auto
mode which optimizes the attenuation setting for the
current signal generator settings.
OFF (0) This choice sets the attenuator to manual mode and
holds the attenuator at its current setting.
Example
:DM:EXT:INP:ATT:AUTO OFF
The preceding example sets the external I/Q attenuator to manual mode.
This command sets the I/Q signal voltage level at the external I/Q inputs. The
voltage level set with this command is used as the input level setting for
automatic attenuation.
Example
:DM:EXT:INP:ATT:LEV 100MV
The preceding example sets the voltage level for the I and Q inputs to 100
millivolts.
*RST +4.00000000E−001
Range .05 to 1 Volt
Key Entry I/Q Output Atten
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 57
Basic Function Commands
Digital Modulation Subsystem—N5172B/82B ([:SOURce])
This command selects the external measurement used to set the attenuator
level. The modulation attenuation must be in Auto mode and is enabled by the
:DM:EXTernal:INPut:ATTen:AUTO command.
DEFault Use this choice to set the external I/Q input level to the
MANual Use this choice to manually set the external input level.
MEASurement This choice uses a real–time measurement of the
Example
:DM:EXT:INP:ATT:MODE MAN
The preceding example sets manual as the method for setting the external I/Q
input level.
*RST DEFault
Key Entry Ext Input Level (nnn mV) Default Man Meas
:DM:EXTernal:POLarity
default value of 500.0 mV.
The input level is set by using the
:DM:EXTernal:INPut:ATTen:LEVel command.
external input level to set the attenuator level. The
measurement will be used to set the attenuator level
setting and is performed by using the
:DM:EXTernal:INPut:ATTen:LEVel:MEASurement
command.
58 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Digital Modulation Subsystem—N5172B/82B ([:SOURce])
This command, for backward compatibility with older signal generator models,
selects normal or inverted I/Q routing of signals going out of the rear-panel I
and Q output connectors. In the inverted mode, the Q input is routed to the I
modulator and the I input is routed to the Q modulator.
Example
:DM:EXT:POL INV
The preceding example inverts I and Q signal routing.
This command enables and disables the RF and baseband magnitude and
phase corrections across the 160 MHz baseband bandwidth, at the current
frequency.
When this feature is on, arbitrary frequency switching while the baseband is on
will take up to an additional 3.3ms (typical) to 6.8ms the first time that
frequency is specified. After that, switching to that frequency will take up to an
additional 1.3ms. Up to 1024 unique frequencies can be cached before the
oldest cache will be forgotten. If a frequency sweep is activated, then the
calculation and caching will occur up front for the first 1024 unique
frequencies, and all further unique frequencies will have the characteristics of
arbitrary frequency switching.
If the I/Q correction optimized path is set to Ext I/Q Output, then only the
baseband corrections are applied and the frequency switching is unaffected.
This correction is convolved with the ACP internal I/Q channel optimization
filter and the equalization filter, if they are active. The resulting filter is
truncated to 256 taps.
Example
:DM:INT:CHAN:CORR ON
The preceding example enables the internal channel correction calibration.
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 59
Basic Function Commands
Digital Modulation Subsystem—N5172B/82B ([:SOURce])
This command selects between optimizing the internal I/Q channel for EVM (in
channel performance) at the expense of ACP (out of channel performance) or
optimizing for ACP at the expense of EVM.
EVM is an 80% Nyquist filter (160 MHz wide) with a wide transition band.
When an equalization filter is active, this filter is not active.
ACP is an 80% Nyquist filter (160 MHz wide) with a narrow transition band,
thus reducing images for wide-band signals. This filter will be convolved with
the active equalization filter, the result of which will be truncated to the center
256 taps.
This command selects the FIR file to use as the equalization filter. Equalization
filters are typically complex and must have an oversample ratio of 1. The filter
must not have more than 256 taps (512 coefficients for a complex filter). The
equalization filter operates at 200 MHz, so all equalization filters must be
resampled to 200 MHz if they are sampled at some other rate.
This command enables or disables the I/Q internal equalization filter. This filter
can be used to correct and/or impair the RF and external I/Q outputs for the
internal I/Q source. This filter will be convolved with the ACP internal I/Q
Channel Optimization filter if that filter is selected, the result of which will be
truncated to the center 256 taps. The equalization filter operates at 200 MHz,
so all equalization filters must be resampled to 200 MHz if they are sampled at
some other rate.
Applying I/Q Delay or I/Q Timing Skew will reduce the actual number of
coefficients available in the hardware by 2 taps for every integral step of
5ns of delay or 10 ns of skew.
*RSTOff
60 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Digital Modulation Subsystem—N5172B/82B ([:SOURce])
This command enables you to change the absolute phase of both I and Q with
respect to triggers and markers. A positive value delays I and Q. This value
affects both the external I/Q out signals and the baseband signal modulated
on the RF output. This adjustment does not affect external I/Q inputs.
The variable <value> is expressed in seconds.
*RST +0.00000000E+000
Range −400 το 400 νανοσεχονδσ (νσ)
Key Entry I/Q Delay
Remarks This command is effective only if the state of the I/Q
adjustment function is set to ON. Refer to the
:DM:IQADjustment[:STATe] command.
This command sets the common mode offset range voltage (COARse or FINE)
for both the in–phase (I) and quadrature–phase (Q) signals going out of the
rear panel I and Q output connectors.
The common mode offset range is expressed in units of volts (mV–V). The
COARse range corresponds to a pre–existing adjustment range of ±2.5 V.
When the FINE range is enabled, the common mode offset is limited to ±100
mV.
*RST COAR
Range −2.5 to 2.5 V (Coarse), −100 to 100 mV (Fine)
Key Entry Common Mode I/Q Offset Range
Remarks This command is effective only if the state of the I/Q
adjustment function is set to on. Refer to the
:DM:IQADjustment[:STATe] command.
:DM:IQADjustment:EXTernal:COFFset
SupportedN5172B/82B
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 61
Basic Function Commands
Digital Modulation Subsystem—N5172B/82B ([:SOURce])
This command sets the common mode offset voltage for both the in–phase (I)
and quadrature–phase (Q) signals going to the rear panel I and Q output
connectors.
The variable <value> is expressed in units of volts (mV–V).
*RST +0.00000000E+000
Range −2.5 to 2.5 V
Key Entry Common Mode I/Q Offset
Remarks This command is effective only if the state of the I/Q
adjustment function is set to ON. Refer to the
:DM:IQADjustment[:STATe] command.
This command adjusts the phase angle (quadrature skew) between the I and Q
vectors by increasing or decreasing the Q phase angle. This command adjusts
the signals externally input to the signal generator’s front-panel Q input
connector. For more information on this connector, refer to the User’s Guide.
The <value> variable is expressed in degrees with a minimum resolution of 0.1.
If the signal generator is operating at frequencies greater than 3.3 GHz,
quadrature skew settings greater than ±5 degrees will not be within
specifications.
Positive skew increases the angle from 90 degrees while negative skew
decreases the angle from 90 degrees. When the quadrature skew is zero, the
phase angle between the I and Q vectors is 90 degrees.
This command is effective only if the state of the I/Q adjustment function is set
to ON. Refer to the :DM:IQADjustment[:STATe] command.
Example
:DM:IQAD:EXT:QSK 4.5
The preceding example increases the phase angle by 4.5 degrees.
*RST +0.00000000E+000
Range −200 to +200
Key Entry Quadrature Angle Ad justment
64 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Digital Modulation Subsystem—N5172B/82B ([:SOURce])
This command adjusts the ratio of I to Q while preserving the composite, vector
magnitude. Adding gain (+x dB) to the signal increases the I component and
decreases the Q component proportionally. Reducing gain (–x dB) decreases
the I component and increases the Q component proportionally.
The variable <value> is expressed in units of decibels (dB).
*RST +0.00000000E+000
Range −1 to 1
Key Entry I/Q Gain Balance
Remarks This command is effective only if the state of the I/Q
adjustment function is set to ON. Refer to the
:DM:IQADjustment[:STATe] command.
When using this command to minimize the LO feedthrough signal, optimum
performance is achieved when the command is sent after all other I/Q path
commands are executed, such as those that change the internal phase polarity
or adjust the modulator attenuator. If other adjustments are made after
minimizing is performed, the LO feedthrough signal may increase.
The variable <value> is expressed in units of percent with a minimum resolution
of 0.025.
*RST +0.00000000E+000
Range −20.000 to 20.000
Key Entry I Offset
Remarks This command is effective only if the state of the I/Q
adjustment function is set to ON. Refer to the
:DM:IQADjustment[:STATe] command.
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 65
Basic Function Commands
Digital Modulation Subsystem—N5172B/82B ([:SOURce])
This feature allows adjustment of the absolute phase of the internal I/Q
channel by rotating both I and Q, and so adjusting the relative phase of the RF
carrier. For MXGs with Option 012, this is the only way to adjust the phase for a
unit with an external LO.
The I/Q signal will be scaled down by 0.7071 for all phase offsets except 0.
Use -360 or +360, if it is desirable to maintain a constant power level with
the ALC off while adjusting the I/Q phase.
The variable <value> is expressed in units of degrees with a resolution of 0.01
degrees. <unit> can be nothing or DEG for degrees.
*RST +0.00000000E+000
Range −360.000 to 360.000
Key Entry I/Q Phase
:DM:IQADjustment:QOFFset
SupportedN5172B/82B
[:SOURce]:DM:IQADjustment:QOFFset
[:SOURce]:DM:IQADjustment:QOFFset?
This command adjusts the Q channel offset value.
When using this command to minimize the LO feedthrough signal, optimum
performance is achieved when the command is sent after all other I/Q path
commands are executed, such as those that change the internal phase polarity
or adjust the modulator attenuator. If other adjustments are made after
minimizing is performed, the LO feedthrough signal may increase.
The variable <value> is expressed in units of percent with a minimum resolution
of 0.025.
*RST +0.00000000E+000
Range −20.000 to 20.000
Key Entry Q Offset
Remarks This command is effective only if the state of the I/Q
adjustment function is set to on. Refer to the
:DM:IQADjustment[:STATe] command.
66 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Digital Modulation Subsystem—N5172B/82B ([:SOURce])
This command adjusts the phase angle (quadrature skew) between the I and Q
vectors by increasing or decreasing the Q phase angle.
The <value> variable is expressed in degrees with a minimum resolution of 0.1.
If the signal generator is operating at frequencies greater than 3.3 GHz,
quadrature skew settings greater than ±5 degrees will not be within
specifications.
Positive skew increases the angle from 90 degrees while negative skew
decreases the angle from 90 degrees. When the quadrature skew is zero, the
phase angle between the I and Q vectors is 90 degrees.
This command is effective only if the state of the I/Q adjustment function is set
to ON. Refer to the :DM:IQADjustment[:STATe] command.
Example
:DM:IQAD:QSK 4.5
The preceding example increases the phase angle by 4.5 degrees.
This command changes the I/Q skew which is a time delay difference between
the I and Q signals. Equal and opposite skew is applied to both I and Q and
affects the RF Output and I/Q output paths simultaneously. A positive value
delays the I signal relative to the Q signal, and a negative value delays the Q
signal relative to the I signal.
Example
:DM:IQAD:SKEW 5E–9
The preceding example sets the time delay difference between the I and Q
signals to 5 nanoseconds.
*RST +0.00000000E+000
Range −800 to +800 ns
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 67
Basic Function Commands
Digital Modulation Subsystem—N5172B/82B ([:SOURce])
This command sets the power level difference (ratio) between the source one
and source two signals when the two signals are summed together. A positive
ratio value reduces the amplitude for source two, while a negative ratio value
reduces the amplitude for source one.
:DM:STATe
[:SOURce]:DM:STATe ON|OFF|1|0
[:SOURce]:DM:STATe?
ExternalInternalSum
Supported N5172B/82B
*RST +0.00000000E+000
Range ± 50 dB
Key Entry Summing Ratio (SRC1/SRC2) x.xx dB
Supported N5172B/82B
This command enables or disables the I/Q modulator.
The I/Q modulator is enabled whenever a digital format is turned on.
The I/Q annunciator will be shown on the signal generator display whenever
the I/Q modulator is on.
ON (1) This choice enables the internal I/Q modulator.
OFF (0) This choice disables the internal I/Q modulator. You can
turn off the I/Q with this choice even though a digital
format is enabled. With this configuration, the RF
output signal will not be modulated, but the I/Q signals
may be present at the rear panel I and Q outputs
depending on the rear panel output selection.
*RST 0
Key Entry I/Q Off On
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 69
Basic Function Commands
Frequency Subsystem ([:SOURce])
This command sets the center frequency for a step sweep. The center
frequency symmetrically divides the selected frequency span and is coupled to
the start and stop frequency settings. The frequency range and reset values are
dependent on the signal generator model and option number.
The query returns the start and stop frequencies if the optional MAXimum or
MINimum are used.
*RSTThe preset value is model/option dependent. Refer to
the instrument’s Data Sheet.
RangeThe range is model/option dependent. Refer to the
instrument’s Data Sheet.
Example
:FREQ:CENT .5 GHz
The preceding example sets the center frequency for a sweep to .5 GHz.
This command sets the frequency of the signal generator by specifying a
frequency channel band. The frequency channel state must be enabled for this
command to work.
Refer to the :FREQuency:CHANnels[:STATe] command.
SCPI ParameterFrequency Channel Band
Standard
Selected
NBASeStandard BaseNADC
NMOBileStandard MobileNADC
70 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Frequency Subsystem ([:SOURce])
SCPI ParameterFrequency Channel Band
Selected
BPGSmP-Gsm 900 BaseGSM
MPGSmP-Gsm 900 MobileGSM
BEGSmE-Gsm 900 BaseGSM
MEGSmE-Gsm 900 MobileGSM
BRGSmR-Gsm 900 BaseGSM
MRGSmR-Gsm 900 MobileGSM
BDCSDCS 1800 BaseGSM
MDCSDCS 1800 MobileGSM
BPCSPCS 1900 BaseGSM
MPCSPCS 1900 MobileGSM
B450Gsm 450 BaseGSM
GM450Gsm 450 MobileGSM
B480Gsm 480 BaseGSM
Standard
M480Gsm 480 MobileGSM
B850Gsm 850 BaseGSM
M850Gsm 850 MobileGSM
B8800MHz BasePDC
M8800MHz MobilePDC
B151500MHz BasePDC
M151500MHz MobilePDC
B390Base 390-400TETRA
B420Base 420-430TETRA
B460Base 460-470TETRA
B915Base 915-921TETRA
M380Mobile 380-390TETRA
M410Mobile 410-420TETRA
M450Mobile 450-460TETRA
M870Mobile 870-876TETRA
PHSStandard PHSPHS
DECTStandard DECTDECT
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 71
Basic Function Commands
Frequency Subsystem ([:SOURce])
Example
:FREQ:CHAN:BAND DECT
The preceding example sets the frequency band to standard DECT.
This command enables or disables the frequency channel and band selection.
The signal generator frequency will be set to the channel frequency when the
state is on. To set frequency channel bands refer to the
:FREQuency:CHANnels:BAND command.
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 73
Basic Function Commands
Frequency Subsystem ([:SOURce])
Example
:FREQ:CHAN ON
The preceding example turns on the frequency channel.
This command sets the signal generator output frequency, or increments or
decrements the current RF frequency setting.
<val> A frequency value.
UP Increases the current frequency setting by the value set
DOWN Decreases the current frequency setting by the value set
*RSTOption 501: +10000000000000E+09
power. Refer to the [:LEVel][:IMMediate][:AMPLitude]
command for the correct specified frequency and
amplitude settings. To set the frequency mode refer to
the :FREQuency:MODE command.
with the front-panel up-arrow key.
with the front-panel down-arrow key.
Option 503: +30000000000000E+09
Option 506: +60000000000000E+09
74 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Frequency Subsystem ([:SOURce])
RangeOption 501: 9kHz–1GHz
Option 503: 9kHz–3GHz
Option 506: 9kHz–6GHz
RemarksTo set the frequency mode to FIXed, refer to
A frequency change may affect the current output
power. Refer to [:LEVel][:IMMediate][:AMPLitude] for
the correct specified frequency and amplitude settings.
This command enables the mode to improve non-harmonics performance (low
spurs mode). Enabling this mode affects switching speed.
This command sets the frequency mode of the signal generator to CW or
swept.
CW and FIXed These choices are synonymous with one another and
non-harmonics.
non-harmonics.
stops a frequency sweep, allowing the Keysight MXG to
operate at a set frequency. Refer to the
:FREQuency[:CW] command for setting the frequency in
the CW mode and to the :FREQuency:FIXed command
for setting the frequency in the FIXed mode.
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 75
Basic Function Commands
Frequency Subsystem ([:SOURce])
LIST This choice selects the swept frequency mode. If sweep
To perform a frequency and amplitude sweep, you must also select LIST as
the power mode. See the
amplitude sweep.
triggering is set to immediate along with continuous
sweep mode, executing the command starts the LIST or
STEP frequency sweep.
:MODE command for selecting the list mode for an
This command sets the multiplier for the signal generator carrier frequency.
This displayed frequency equals the actual frequency times the multiplier.
*RST +1.00000000E+000
Range Negative values: -1000 to -0.001
Key Entry Freq Multiplier
Remarks For any multiplier other than one, the MULT indicator is
The query of this command returns a value equal to the original output
frequency times the multiplier value, plus the frequency offset value. This
displayed frequency equals the actual frequency times the multiplier.
Positive values: 0.001 to 1000
shown in the frequency area of the display.
When an offset has been entered, the OFFS indicator is turned on in the
frequency area of the display.
The frequency offset state is turned on when any non–zero value is entered;
entering zero will turn it off. Refer to the :FREQuency:OFFSet:STATe command
for setting the offset state independent of entering offset values.
76 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Frequency Subsystem ([:SOURce])
This command sets the length of the frequency range for a step sweep. Span
setting is symmetrically divided by the selected center frequency and is
coupled to the start and stop frequency settings. The span range is dependent
on the signal generator model and option number.
Example
:FREQ:SPAN 100MHz
The preceding example sets the frequency span to 100 megahertz.
This command tunes the internal oven oscillator frequency.
The user value offsets the factory tuned value (the value is added to the factory
calibrated DAC value). The tune value of 0 sets the factory calibrated value.
This command enables or disables the ability of the signal generator to
automatically select between the internal and an external reference oscillator.
ON (1) This choice enables the signal generator to detect when
a valid reference signal is present at the 10 MHz IN
connector and automatically switches from internal to
external frequency reference.
OFF (0) This choice selects the internal reference oscillator and
disables the automatic switching capability between
the internal and an external frequency reference.
*RST 1
Key Entry Ref Oscillator Source Auto Off On
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 81
Basic Function Commands
Frequency Subsystem ([:SOURce])
This command tunes the internal VCTXCO oscillator frequency.
The user value offsets the factory tuned value (the value is added to the factory
calibrated DAC value). The tune value of 0 sets the factory calibrated value.
*RST +0.00000000E+000
Range −8192 to +8191
Key Entry Ref Oscillator Tune
82 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
List/Sweep Subsystem ([:SOURce])
A complete sweep setup requires commands from other subsystems. Table
shows the function and location of these other commands.
Table 2-1 Location of Commands from the other Subsystems
Sweep TypeFunctionCommand LocationKey Entry under
Sweep/List key
List and StepConfiguring frequency sweep
Configuring amplitude sweep
Configuring frequency and
amplitude sweep
Enables or Disables the
waveform sweep
Set up and control sweep
triggering
ListLoad a list sweep file
Store list sweep data to a file
Selects the waveform for the
current waveform sequence
List Sweep
Options Flags
This command enables
specific options during a list
sweep.
a
b
page 75Freq Off On
page 114Amptd Off On
page 75
page 114
Freq & Amptd
Off On
page 387Waveform Off
On
page 241See the “Trigger
Subsystem”
page 184Load From
Selected File
page 180Store To File
page 75
no softkey
page 84
page 92
page 86
no softkey. Refer to
Table 2-2 on
page 87
StepStart frequency sweep
Store list sweep data to a file
Start amplitude sweep
Stop amplitude sweep
page 78Freq Start
page 180Store To File
page 116Amptd Start
page 116Amptd Stop
a. Execute both commands to start or stop a frequency and amplitude sweep.
b. For point to point triggering, see “:LIST:TRIGger:SOURce” on page 90.
:LIST:CPOint?
SupportedAll Models
[:SOURce]:LIST:CPOint?
This query returns the current sweep point.
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 83
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 85
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
This command sets a list or step sweep point as the current sweep point
controlling the frequency and power output.
If list or step mode is controlling frequency or power, or both, then the indexed
point in the respective list(s) will be used.
Entering a value with this command will have no effect, unless MANual is the
selected mode. Refer to the :LIST:MODE command for setting the proper
mode.
If the point selected is beyond the length of the longest enabled list, then the
point will be set to the maximum possible point, and an error will be generated.
Range List Sweep: 1 to 3,201 Step Sweep: 2 to 65535
Key Entry Manual Point
Supported All Models
This command sets the operating mode for the current list or step sweep.
AUTO This choice enables the selected sweep type to perform
MANual This choice enables you to select a single sweep point.
*RST AUTO
Key Entry Manual Mode Off On
:LIST:OPTions
SupportedAll Models
[:SOURce]:LIST:OPTions <val>,<val>
[:SOURce]:LIST:OPTions?
[:SOURce]:LIST:OPTions:POINts?
This command enables specific options during a list sweep. The command
adds the capability to suppress FM, fM, and AM on any list sweep point.
Additionally, frequency, power, and/or a waveform transition can be
suppressed resulting in no synthesizer, no output, or no waveform playing
interruption during a transition.
a sweep of all points.
The selected point controls the frequency and/or
amplitude according to the sweep type. Refer to the
:LIST:MANual command for selecting a sweep point.
86 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
This is a SCPI command only feature. There is no signal generator
user interface displayed indication that these option flags are in use. The
option flag list is preset to empty when list sweep is preset with the defaults.
Otherwise, the option flag changes are persistent.
See also “:LIST:TYPE:LIST:INITialize:PRESet” on page 91.
Table 2-2 List Sweep Options Flag.
Bit #Bit ValueOption if set
01Suppress Frequency Change
12 Suppress Power Change
24 Suppress Waveform Change
38Suppress FM and fM
416Suppress AM
The table represents the value of a bit flag.
If a bit is not set, then the option is ignored (not applied).
If FM, fM is not turned on, the FM, fM suppression does nothing.
The FM, fM should be typically as in CW mode.
The AM suppressing is accomplished by grounding the input to the AM
modulator, no other reconfiguration of HW is performed.
The AM should be set up in CW mode.
Example
FM:DEV 1E6
FM:STAT ON
LIST:FREQ 1E9,2E9,3E9,4E9
LIST:OPT 8,0,8,0
The preceding example sets up FM then a frequency list of 1, 2, 3, 4 GHz and
suppresses FM on every other list sweep point (points 1 and 3 will have FM
suppressed, points 2 & 4 will have FM enabled).
This command configures the sweep to retrace to the first sweep point, or stop
at the last sweep point upon completion of each sweep.
ON (1) The sweep retraces to the first sweep point.
OFF (0) The sweep stays at the last sweep point of the
completed sweep and stays there until sweep is
initiated and triggered again. When sweep is initiated
and triggered again, the sweep point moves to the first
point of the sweep.
This command sets the polarity of an external signal at the TRIG 1, TRIG 2, or
PULSE BNC (see :LIST:TRIGger:EXTernal:SOURce) or internal Pulse Video or
Pulse Sync signal (see :LIST:TRIGger:INTernal:SOURce) that will trigger a list
or step sweep.
POSitive The signal generator triggers an event when it detects a
rising edge on the source signal
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 89
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
NEGative The signal generator triggers an event when it detects a
This command toggles between the two types of sweep.
90 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
LIST This type of sweep has arbitrary frequencies and
amplitudes.
STEP This type of sweep has equally spaced frequencies and
amplitudes.
*RST STEP
Key Entry Sweep Type List Step
:LIST:TYPE:LIST:INITialize:FSTep
SupportedAll Models
The current list sweep data will be overwritten once this command is
executed. If needed, save the current data. Refer to the “:STORe:LIST”
command for storing list sweep files.
[:SOURce]:LIST:TYPE:LIST:INITialize:FSTep
This command replaces the loaded list sweep data with the settings from the
current step sweep data points.
You can load only one sweep list at a time.
The maximum number of list sweep points is 3,201. When copying the step
sweep settings over to a list sweep, ensure that the number of points in the
step sweep do not exceed the maximum list sweep points.
Key Entry Load List From Step Sweep
:LIST:TYPE:LIST:INITialize:PRESet
SupportedAll Models
The current list sweep data will be overwritten once this command is
executed. If needed, save the current data. Refer to the “:STORe:LIST”
command for storing list sweep files.
[:SOURce]:LIST:TYPE:LIST:INITialize:PRESet
This command replaces the current list sweep data with a factory–defined file
consisting of one point at a frequency, amplitude, and dwell time.
Key Entry Preset List
Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference 91
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
:LIST:WAVeform
SupportedN5172B/82B
The current list sweep data will be overwritten once this command is
executed. If needed, save the current data. Refer to the “:STORe:LIST”
command for storing list sweep files.
This command enables protection for the mechanical attenuator by
automatically turning on Atten Hold during frequency and/or power step
sweeps.
92 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
List/Sweep Subsystem ([:SOURce])
This may cause unleveled RF output to occur for certain sweep configurations.
Disabling this attenuator protection will allow the sweep to optimally set both
the automatic leveling control (ALC) and output attenuation at each sweep
point.
ON (1) This choice enables attenuator protection.
OFF (0) This choice disables attenuator protection. When the
Example
:SWE:ATT:PROT 0
The preceding example disables attenuator protection.
*RST 1
Key Entry Step Atten Protection On Off
:SWEep:CPOINt?
attenuator protection is disabled, the step dwell time
will be set to a minimum of 50 ms as a precaution.
SupportedAll Models
[:SOURce]:SWEep:CPOINt?
This query returns the current sweep point in any mode.
This command sets the step size for a linear step sweep in frequency
(difference between frequency points).
The variable <value> is expressed in units of frequency, specifies by the
variable <unit> (as Hz, kHz, MHz, or GHz).
NOTE: Setting the step size will determine the number of points in the step
sweep based on the current start and stop frequencies. Due to the integer
number of step points, the step size may be adjusted in order to yield a true
linear sweep between the start and stop frequencies.
This command sets the step size for a logarithmic step sweep in frequency
(ratio between frequency points).
The variable <value> is expressed as a percentage (%).
NOTE: Setting the step size will determine the number of points in the step
sweep based on the current start and stop frequencies. Due to the integer
number of step points, the step size may be adjusted in order to yield a true
linear sweep between the start and stop frequencies.
This command sets the amplitude marker state for the currently activated
markers. When the state is switched on, the RF output signal exhibits a spike
with a magnitude relative to the power level at each marker’s set frequency.
(To set the magnitude of the spike, refer to the :MARKer:AMPLitude:VALue
command.)
This command sets the relative power for the amplitude spikes at each
marker’s set frequency when the amplitude marker mode is activated. (To
activate the amplitude markers, refer to the :MARKer:AMPLitude[:STATe]
command.)
Example
:MARK:AMPL:VAL 4DB
The preceding example sets the relative marker power to 4 dB for all markers.
*RST 2 dB
Range −10 to +10 dB
Key Entry Marker Value
:MARKer:AOFF
SupportedN5173B/83B
[:SOURce]:MARKer:AOFF
This command turns off all active markers.
96 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Basic Function Commands
Marker Subsystem–N5173B/83B ([:SOURce])
Key Entry Turn Off Markers
:MARKer:DELTa
SupportedN5173B/83B
[:SOURce]:MARKer:DELTa? <num>,<num>
This query returns the frequency difference between two amplitude markers.
The variables <num> are used to designate the marker numbers.
Example
:MARK:DELT? 1,2
The preceding example returns the frequency difference between amplitude
markers 1 and 2.
This command sets the frequency mode for all markers.
FREQuency The frequency values for the markers are absolute.
DELTa The frequency values for the markers are relative to the
Example
:MARK:MODE DELT
The preceding example sets the marker mode to delta.
*RSTFREQuency
Key Entry
:MARKer:REFerence
designated reference marker. The reference marker
must be designated before this mode is selected. (See
the :MARKer:REFerence command to select a reference
marker.)
This command overrides the signal generator's automatic ALC bandwidth
selection with the users specific selection. For waveforms with varying
amplitudes, high crest factors, or both, the recommended ALC loop bandwidth
is the low bandwidth setting of the generator. Limiting the loop bandwidth of
the ALC circuit will prevent the ALC from sampling the fast rising edges of
pulsed waveforms. A limited, or narrow bandwidth will result in a longer ALC
sample time and a more accurate representation of the signal's level.
*RST 200 (2kHz when ALC:BAND:BWID is set to AUTO)
Key Entry
Remarks Use this command when the ALC state is set to On. This
Auto200 Hz2 kHz20 kHz
command will override the automatic ALC bandwidth
selection set by the :ALC:BANDwidth|BWIDth:AUTO
command.
This command sets the automatic leveling control (ALC) level. Use this
command after setting the attenuation auto mode to On. Refer to
:ATTenuation:AUTO command for setting the attenuation auto mode.
The ALC is used to maintain the signal generator’s output power level by
compensating for power fluctuations due to drift, band changes, or load
variations. After you set the ALC level, the signal generator’s output power is
monitored and corrected so that the power level setting is maintained.
This command executes a power search routine that temporarily activates the
ALC, calibrates the power of the current RF output, and then disconnects the
ALC circuitry. The power search mode is active only when the ALC state is Off,
and the RF output is On.
Range –20 to 20
Key Entry Set ALC Level
Supported All Models
ON (1) This choice sets the power search mode to automatic
(Auto). In automatic mode, the power search calibration
routine is executed whenever an instrument setting is
modified that affects RF output power. This includes
changes to frequency, amplitude and modulation.
OFF (0) This choice sets the power search mode to Manual and
disables the automatic power search calibration
routine. The power level must be calibrated by explicitly
sending the ONCE command. If there is a change in
frequency or amplitude the ONCE command must be
sent again.
100 Keysight EXG and MXG X-Series Signal Generators SCPI Command Reference
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.