Licensed software products are owned by T ektronix or its suppliers and are protected by United States copyright laws and
international treaty provisions.
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the
Rights in T echnical Data and Computer Software clause at DFARS 252.227-7013, or subparagraphs (c)(1) and (2) of the
Commercial Computer Software – Restricted Rights clause at F AR 52.227-19, as applicable.
T ektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supercedes
that in all previously published material. Specifications and price change privileges reserved.
T ektronix Japan, Ltd., 5–9–31 Kitashinagawa, Shinagawa–ku, Tokyo 141–0001 Japan
T ektronix, Inc., P.O. Box 500, Beaverton, OR 97077
TEKTRONIX and TEK are registered trademarks of T ektronix, Inc.
Windows and Windows 98 are trademarks of Microsoft Corporation.
WARRANTY
T ektronix warrants that this product will be free from defects in materials and workmanship for a period of one (1) year
from the date of shipment. If any such product proves defective during this warranty period, T ektronix, 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.
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 T ektronix, with shipping charges prepaid.
T ektronix shall pay for the return of the product to Customer if the shipment is to a location within the country in which the
T ektronix service center is located. Customer shall be responsible for paying all shipping charges, duties, taxes, and any
other charges for products returned to any other locations.
This warranty shall not apply to any defect, failure or damage caused by improper use or improper or inadequate
maintenance and care. T ektronix shall not be obligated to furnish service under this warranty a) to repair damage resulting
from attempts by personnel other than T ektronix representatives to install, repair or service the product; b) to repair
damage resulting from improper use or connection to incompatible equipment; or c) to service a product that has been
modified or integrated with other products when the effect of such modification or integration increases the time or
difficulty of servicing the product.
THIS WARRANTY IS GIVEN BY TEKTRONIX WITH RESPECT TO THIS PRODUCT IN LIEU OF ANY
OTHER WARRANTIES, EXPRESSED OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
TEKTRONIX’ RESPONSIBILITY TO REPAIR OR REPLACE DEFECTIVE PRODUCTS IS THE SOLE AND
EXCLUSIVE REMEDY PROVIDED TO THE CUST OMER FOR BREACH OF THIS WARRANTY. TEKTRONIX
AND ITS VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT , SPECIAL, INCIDENTAL, OR
CONSEQUENTIAL DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX OR THE VENDOR HAS
ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.
This programmer manual is for the WCA230A and WCA280A Portable Wireless
Communication Analyzers. It provides information on operating your analyzer
using the General Purpose Interface Bus (GPIB).
This manual is composed of the following sections:
HGetting Started outlines how to use the GPIB interface.
HSyntax and Commands defines the syntax used in command descriptions,
presents a list of all command subsystems, and presents detailed descriptions
of all programming commands.
HStatus and Events describes how the status and Events Reporting system
operates and presents a list of all system errors.
HProgramming Examples describes some example analyzer programs.
HAppendices provides additional information including character charts, GPIB
interface specification, and factory initialization settings.
Related Manual
WCA230A & WCA280A User Manual
(Standard accessory; Tektronix part number 071-1253-XX)
Describes how to install the analyzer and how to work with the menus and
details the functions.
Difference between WCA230A and WCA280A
WCA230A and WCA280A have the same functions except for their measurement frequency ranges:
WCA230ADC to 3 GHz. . . . . . . . .
WCA280ADC to 8 GHz. . . . . . . . .
Unless otherwise noted, descriptions in this manual apply to both.
WCA230A & WCA280A Programmer Manual
xv
Preface
xvi
WCA230A & WCA280A Programmer Manual
Getting Started
You can write computer programs that remotely set the analyzer front panel
controls or that take measurements and read those measurements for further
analysis or storage.
To help you get started with programmng the analyzer, this section includes the
following sections:
HOverview of the Manual
Summarizes the type of programming information contained in each major
section of this manual.
HConnecting the Interface
Describes how to physically connect the analyzer to a controller.
HUsing GPIB Ports
Describes how to use the GPIB port.
HSetting the GPIB Parameters from the Front Panel
Describes how to set the GPIB parameters from the front panel.
WCA230A & WCA280A Programmer Manual
1-1
Getting Started
Overview of the Manual
The information contained in each major section of this manual is described
below.
Syntax and Commands
:CALCulate Commands
:TRIGger
:ABORt Commands
IEEE Common Commands
*CAL?
*CLS
*ESE
*ESR
*IDN?
*OPC
Section 2, Syntax and Commands, describes the structure and content of the
messages your program sends to the analyzer. Figure 1–1 shows command parts
as described in the Command Syntax subsection.
Command parts
Header
Comma
:MMEMory:COPYFILE1,FILE2
Mnemonics
Figure 1-1: Command parts
Section 2 also describes the effect of each command and provides examples of
how you might use it. The Command Groups section provides lists by functional
areas. The IEEE Common Commands and the subsequent sections arrange
commands alphabetically (Figure 1–2).
ArgumentsSpace
:CALCulate:MARKer:X
:CALCulate:MARKer:AOFF
S
A
E
:CALCulate:DLINe
S
A
Syntax: . . .
E
Arguments:
Examples: . . .
Commands grouped in functional areasCommands listed alphabetically
Figure 1-2: Functional groupings and an alphabetical list of commands
1-2
WCA230A & WCA280A Programmer Manual
Getting Started
Status and Events
The program may request information from the analyzer. The analyzer provides
information in the form of status and error messages. Figure 1–3 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.
Your program requests
status and event reports.
Controller
The analyzer sends status and event reports.
WCA230A/WCA280A
GPIB cable
Figure 1-3: EventĆdriven program
Programming Examples
Section 4, Programming Examples, includes Visual C++ source code as well as
sample programs for running macro programs.
Figure 1-4: Sample program (Visual C++ source code)
WCA230A & WCA280A Programmer Manual
1-3
Getting Started
Connecting the Interface
The analyzer has a 24-pin GPIB connector on its rear panel, as shown in
Figure 1–5. 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.
GPIB connector
1-4
Figure 1-5: GPIB connector (rear panel)
Appendix B: GPIB Interface Specifications gives more information on the GPIB
configuration of the analyzer.
For the other interfaces, refer to the WCA230A & WCA280A User Manual.
WCA230A & WCA280A Programmer Manual
Using the GPIB Port
Getting Started
The analyzer has Talker/Listener functions through which it can communicate
with other devices, as well as the external controller, located on the bus.
GPIB
ControllerUsing the analyzer as a talker or listener
Figure 1-6: GPIB connection
GPIB Requirements
Observe these rules when you use your analyzer with a GPIB network:
HAssign a unique device address to each device on the bus. No two devices
can share the same device address.
HDo not connect more than 15 devices to any one bus.
HConnect one device for every 2 meters (6 feet) of cable used.
HDo not use more than 20 meters (65 feet) of cable to connect devices to a
bus.
HTurn on at least two-thirds of the devices on the network while using the
network.
HConnect the devices on the network in a star or linear configuration as shown
in Figure 1–7. Do not use loop or parallel configurations.
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
Figure 1-7: Typical GPIB network configurations
WCA230A & WCA280A Programmer Manual
GPIB Device
1-5
Getting Started
Setting the GPIB Parameters from the Front Panel
Set the GPIB parameters as required for the bus configuration. Once you have set
the parameters, you can control the analyzer through the GPIB interface.
1. Press the SYSTEM key in the UTILITY block.
SYSTEM key
2. Press the Remote Setup... side key.
3. Press the Remote Interface side key to select On.
4. Press the side key GPIB Setup..." GPIB Address and set the address
using either the general purpose knob or the numeric keypad.
The range is 0 to 30 (factory default setting: 1).
NOTE. The GPIB address cannot be initialized with *RST command.
Remote Setup menu
Remote Interface
Selects whether the connection
between the analyzer and GPIB
is turned on or not.
GPIB Setup...
Sets the GPIB parameters
such as address.
1-6
Figure 1-8: Setting the GPIB parameters
WCA230A & WCA280A Programmer Manual
Getting Started
To disconnect the analyzer from the bus:
HPress the Remote Interface side key to select Off.
Then, the analyzer is disconnected from the bus, and all the communication
processes with the controller are interrupted.
WCA230A & WCA280A Programmer Manual
1-7
Getting Started
1-8
WCA230A & WCA280A Programmer Manual
Command Syntax
This section contains information on the Standard Commands for Programmable
Instruments (SCPI) and IEEE 488.2 Common Commands you can use to
program your WCA230A/WCA280A analyzer. The information is organized in
the following subsections:
HBackus-Naur Form Definition
HSCPI Commands and Queries
HIEEE 488.2 Common Commands
HConstructed Mnemonics
BackusĆNaur Form Definition
This manual may describe commands and queries using the Backus-Naur Form
(BNF) notation. Table 2–1 defines the standard BNF symbols:
Table 2-1: BNF symbols and meanings
SymbolMeaning
<ą>Defined element
::=Is defined as
|Exclusive OR
{ą}Group; one element is required
[ą]Optional; can be omitted
.ă.Ă.Previous element(s) may be repeated
(ą)Comment
WCA230A & WCA280A Programmer Manual
2-1
Command Syntax
SCPI Commands and Queries
SCPI is a standard created by a consortium that provides guidelines for remote
programming of instruments. These guidelines provide a consistent programming environment for instrument control and data transfer. This environment
uses defined programming messages, instrument responses, and data format
across all SCPI instruments, regardless of manufacturer. The analyzer uses a
command language based on the SCPI standard.
The SCPI language is based on a hierarchical or tree structure (see Figure 2–1)
that represents a subsystem. The top level of the tree is the root node; it is
followed by one or more lower-level nodes.
TRIGger
SEQuence
POLarity
SOURceLEVel
Root node
LowerĆlevel nodes
Figure 2-1: Example of SCPI subsystem hierarchy tree
You can create commands and queries from these subsystem hierarchy trees.
Commands specify actions for the instrument to perform. Queries return
measurement data and information about parameter settings.
2-2
WCA230A & WCA280A Programmer Manual
Command Syntax
Creating Commands
Creating Queries
Query Responses
SCPI commands are created by stringing together the nodes of a subsystem
hierarchy and separating each node by a colon.
In Figure 2–1, TRIGger is the root node and SEQuence, LEVel, POLarity, and
SOURce are lower-level nodes. To create a SCPI command, start 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, which start on page 2–37, list the valid values for all parameters.
For example, TRIGger:SEQuence:SOURce EXT is a valid SCPI command
created from the hierarchy tree in Figure 2–1.
To create a query, start at the root node of a tree structure, move down to the end
of a branch, and add a question mark. TRIGger:SEQuence:SOURce? is an
example of a valid SCPI query using the hierarchy tree in Figure 2–1.
The query causes the analyzer to return information about its status or settings.
When a query is sent to the analyzer, only the values are returned. When the
returned value is a mnemonic, it is noted in abbreviated format, as shown in
Table 2–2.
Table 2-2: Query response examples
QueryResponse
:DISPlay:OVIew:SGRam:X:SPAN?10.0E+6
:SENSe:AVERage:TYPE?RMS
A few queries also initiate an operation action before returning information. For
example, the *CAL? query runs a calibration.
WCA230A & WCA280A Programmer Manual
2-3
Command Syntax
Parameter Types
Every parameter in the command and query descriptions is of a specified type.
The parameters are enclosed in brackets, such as <value>. The parameter type is
listed after the parameter and is enclosed in parentheses, for example, (discrete).
Some parameter types are defined specifically for the WCA200A Series
command set and some are defined by ANSI/IEEE 488.2-1987 (refer to
Table 2–3).
Table 2-3: Parameter types used in syntax descriptions
Parameter TypeDescriptionExample
arbitrary block
booleanBoolean numbers or valuesON or 1; OFF or 0
discreteA list of specific valuesMIN, MAX, UP, DOWN
binaryBinary numbers#B0110
octalOctal numbers#Q57, #Q3
hexadecimal
2,3
NR1
1
A specified length of arbitrary data#512234xxxxx . . .
where 5 indicates that the followĆ
ing 5 digits (12234) specify the
length of the data in bytes;
xxxxx ... indicates the data
2
Hexadecimal numbers
#HAA, #H1
(0-9, A, B, C, D, E, F)
numericIntegers0, 1, 15, -1
NR22numericDecimal numbers1.2, 3.141516, -6.5
NR32numericFloating point numbers3.1415E-9, -16.1E5
NRf2numericFlexible decimal number that may
be type NR1, NR2 or NR3
4
string
Alphanumeric characters
See NR1, NR2, and NR3 examĆ
ples
Testing 1, 2, 3"
(must be within quotation marks)
1
Defined in ANSI/IEEE 488.2 as Definite Length Arbitrary Block Response Data."
2
An ANSI/IEEE 488.2-1992Ćdefined parameter type.
3
Some commands and queries will accept a hexadecimal value even though the
parameter type is defined as NR1.
4
Defined in ANSI/IEEE 488.2 as String Response Data."
2-4
WCA230A & WCA280A Programmer Manual
Command Syntax
SCPIĆdefined Parameters. In addition to the ANSI/IEEE 488.2-1987-defined
parameters, WCA200A Series support the following SCPI-defined parameters.
H<NRf> for boolean
OFF|ON|0|1|<NRf>
You can use <NRf> for boolean parameter. The values other than zero (OFF)
are regarded as one (ON).
HMAXimum and MINimum for numeric parameters
You can use MAXimum and MINimum for the numeric parameter <NRf>.
The following example sets the trigger level to the maximum (100%).
:TRIGger[:SEQuence]:LEVel:IF MAXimum
The commands that have numeric parameters support the following query:
<header>? { MAXimum | MINimum }
The query command returns the maximum or minimum acceptable value for
the command. For example,
:TRIGger[:SEQuence]:LEVel:IF? MAXimum
returns 100 indicating the maximum trigger level is 100%.
HUP and DOWN for numeric parameters
The [:SENse]:FREQuency:CENTer command (refer to page 2–330) supports
UP and DOWN for the numeric parameters. The increment/decrement of
The Line Feed (LF) character (ASCII 10), and all characters in the range of
ASCII 127-255 are defined as special characters. These characters are used in
arbitrary block arguments only; using these characters in other parts of any
command yields unpredictable results.
You can abbreviate most SCPI commands, 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 Figure 2–2, 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 instrument.
Long form of a command
Accepted short form of a
command and parameter
ulate3:MARKer:Y 50
:CALC
Minimum information needed for
accepted short form
CALC3:MARK:Y 50
Figure 2-2: Example of abbreviating a command
NOTE. The numeric suffix of a command or query may be included in either the
long form or short form; the analyzer will default to “1” if no suffix is used. In
Figure 2–2, the “3” of “CALC3” indicates that the command is directed to
View 3.
2-6
WCA230A & WCA280A Programmer Manual
Command Syntax
Chaining Commands and
Queries
You can chain several commands or queries together into a single message. To
create a chained message, first create a command or query, add a semicolon (;),
and then add more commands or queries and semicolons until you are done. If
the command following a semicolon is a root node, precede it with a colon (:).
Figure 2–3 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.
Response from first queryResponse from second query
First query
100;1.2E+9
Figure 2-3: Example of chaining commands and queries
If a command or query has the same root and lower-level nodes as the previous
command or query, you can omit these nodes. In Figure 2–4, the second
command has the same root node (TRIG:SEQuence) as the first command, so
these nodes can be omitted.
Figure 2-4: Example of omitting root and lowerĆlevel nodes in a chained message
WCA230A & WCA280A Programmer Manual
2-7
Command Syntax
Unit and SI Prefix
If the decimal numeric argument refers to amplitude, frequency, or time, you can
express it using SI units instead of using the scaled explicit point input value
format <NR3>. (SI units are units that conform to the System 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.
Table 2–4 lists the available units:
Table 2-4: Available units
SymbolMeaning
dBdecibel (relative amplitude)
dBmdecibel (absolute amplitude)
DEGdegree (phase)
Hzhertz (frequency)
PCTpercent (%)
ssecond (time)
Vvolt
The available SI prefixes are shown in Table 2–5 below:
Table 2-5: Available SI prefixes
10
1
GTPEEX
+6
10
+9
SI prefixAFPNUMKMA
Corresponding power 10
1
When the unit is Hz", M" may be used instead of MA" so that the frequency can be represented by MHz".
-18
10
-15
10
-12
10
-9
10
-6
10
-3
10
+3
You can omit a unit in a command, but you must include the unit when using a
SI prefix. For example, frequency of 15 MHz can be described as follows:
15.0E6, 1.5E7Hz, 15000000, 15000000Hz, 15MHz, etc.
(“15M” is not allowed.)
Note that you can use either lower or upper case units and prefixes. The
following examples have the same result, respectively.
170mhz, 170mHz, 170MHz, etc.
250mv, 250mV, 250MV, etc.
10
+12
10
+15
10
+18
2-8
WCA230A & WCA280A Programmer Manual
Command Syntax
General Rules
Here are three general rules for using SCPI commands, queries, and parameters:
HYou 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.’
HYou can use upper case, lower case, or a mixture of both cases for all
commands, queries, and parameters.
SENSE:SPECTRUM:FFT:LENGTHĂ1024
is the same as
sense:spectrum:fft:lengthĂ1024
and
SENSE:spectrum:FFT:lengthĂ1024
NOTE. Literal strings (quoted) are case sensitive. For example: file names.
HNo embedded spaces are allowed between or within nodes.
correct:SENSE:SPECTRUM:FFT:LENGTHĂ1024
incorrect:SENSE: SPECTRUM: FFT: LEN GTHĂ1024
WCA230A & WCA280A Programmer Manual
2-9
Command Syntax
IEEE 488.2 Common Commands
Description
Command and Query
Structure
ANSI/IEEE Standard 488.2 defines the codes, formats, protocols, and usage of
common commands and queries used on the interface between the controller and
the instruments. The analyzer complies with this standard.
The syntax for an IEEE 488.2 common command is an asterisk (*) followed by a
command and, optionally, a space and parameter value. The syntax for an
IEEE 488.2 common query is an asterisk (*) followed by a query and a question
mark. All of the common commands and queries are listed in the last part of the
Syntax and Commands section. The following are examples of common
commands:
H*ESE 16
H*CLS
The following are examples of common queries:
H*ESR?
H*IDN?
2-10
WCA230A & WCA280A Programmer Manual
Constructed Mnemonics
Some header mnemonics specify one of a range of mnemonics. For example, a
channel mnemonic can be either CALCulate1, CALCulate2, CALCulate3, or
CALCulate4. You use these mnemonics in the command just as you do any other
mnemonic. For example, there is a :CALCulate1:MARKer:MODE command, and
there is also a :CALCulate2:MARKer:MODE command. In the command
descriptions, this list of choices is abbreviated as CALCulate<x>. The value of
<x> is the upper range of valid suffixes. If the numeric suffix is omitted, the
analyzer uses the default value of “1”.
Command Syntax
Table 2-6: Constructed mnemonics
SymbolMeaning
CALCulate<x>A view specifier where <x>=1to4.
DLINe<x>A horizontal display line specifier where <x>=1or2.
VLINe<x>A vertical display line specifier where <x>=1or2.
MARKer<x>A marker specifier where <x>=1or2.
TRACe<x>
DATA<x>
A trace specifier where <x>=1or2.
WCA230A & WCA280A Programmer Manual
2-11
Command Syntax
2-12
WCA230A & WCA280A Programmer Manual
Command Groups
This section lists WCA200A Series analyzer commands in two ways. It first
presents them by functional groups. It then lists them alphabetically. The
functional group list starts below. The alphabetical list provides more detail on
each command and starts on page 2–37.
The WCA200A Series analyzers conform to the Standard Commands for
Programmable Instruments (SCPI) 1999.0 and IEEE Std 488.2-1987 except
where noted.
Items followed by question marks are queries; items without question marks are
commands. Some items in this section have a question mark in parentheses (?) in
the command header section; this indicates that the item can be both a command
and a query.
Each command may be available or unavailable, depending on the current
measurement mode. The “Measurement Modes” item in each command
description shows the measurement mode in which the command is available. To
set the measurement mode, use the :INSTrument[:SELect] command (refer to
page 2–239) using one of the mnemonics listed below:
:DISPlay:WAVeform:X[:SCALe]:OFFSet (?)Sets the minimum horizontal, or time, value (i.e., left end).
:DISPlay:WAVeform:X[:SCALe]:PDIVision (?)Sets the horizontal, or time, scale per division.
:DISPlay:WAVeform:Y[:SCALe]:FITRuns autoĆscale.
:DISPlay:WAVeform:Y[:SCALe]:FULLSets the vertical axis to the default fullĆscale.
:DISPlay:WAVeform:Y[:SCALe]:OFFSet (?)Sets the minimum vertical, or amplitude, value (i.e., bottom end).
:DISPlay:WAVeform:Y[:SCALe]:PDIVision (?)Sets the vertical, or amplitude, scale.
:FETCh Commands
The :FETCh commands retrieve the measurements from the data taken by the
latest INITiate command.
If you want to perform a FETCh operation on fresh data, use the :READ
commands, which acquire a new input signal and fetch the measurement results
from that data.
Table 2-15: :FETCh commands
HeaderDescription
:FETCh:AC3Gpp:ACLR?
:FETCh:ADEMod:AM?Returns the AM signal analysis results.
:FETCh:ADEMod:FM?Returns the FM signal analysis results.
:FETCh:ADEMod:PM?Returns the PM signal analysis results.
:FETCh:CCDF?Returns the CCDF measurement results.
:FETCh:DDEMod?Returns the digital modulation analysis measurement results.
:FETCh:DL3Gpp?
:FETCh:GSMedge:MACCuracy?
:FETCh:GSMedge:MCPower?
:FETCh:GSMedge:MODulation?
:FETCh:GSMedge:PVTime?
:FETCh:GSMedge:SPECtrum:MODulation?
:FETCh:GSMedge:SPECtrum:SWITching?
:FETCh:GSMedge:SPURious?
:FETCh:GSMedge:SWITching?
1
2
4
4
4
4
4
4
4
4
Returns the 3GPP ACLR measurement results.
Returns the 3GPP downlink analysis measurement results.
Returns the GSM/EDGE modulation accuracy measurement results.
Returns the GSM/EDGE mean carrier power measurement results.
Returns the GSM/EDGE modulation spectrum measurement results.
Returns the GSM/EDGE power versus time measurement results.
Returns the time amplitude for the modulation spectrum measurement.
Returns the time amplitude for the switching spectrum measurement.
Returns the GSM/EDGE spurious measurement results.
Returns the GSM/EDGE switching spectrum measurement results.
WCA230A & WCA280A Programmer Manual
2-23
Command Groups
Table 2-15: :FETCh commands (Cont.)
HeaderDescription
:FETCh:GSMedge:TAMPlitude:MCPower?
:FETCh:GSMedge:TAMPlitude:PVTime?
:FETCh:GSMedge:TSCode?
4
:FETCh:SPECtrum?Returns spectrum waveform data.
:FETCh:SPECtrum:ACPower?Returns the ACPR measurement results.
:FETCh:SPECtrum:CFRequency?Returns the carrier frequency measurement results.
:FETCh:SPECtrum:CHPower?Returns the channel power measurement results.
:FETCh:SPECtrum:CNRatio?Returns the C/N measurement results.
:FETCh:SPECtrum:EBWidth?Returns the emission bandwidth measurement results.
:FETCh:SPECtrum:OBWidth?Returns the OBW measurement results.
:FETCh:SPECtrum:SPURious?Returns the spurious signal measurement results.
:FETCh:TRANsient:FVTime?Returns the frequency vs. time measurement results.
:FETCh:TRANsient:IQVTime?Returns the I/Q level vs. time measurement results.
:FETCh:TRANsient:PVTime?Returns the power vs. time measurement results.
:FETCh:UL3Gpp?
1
Option 22 and 23
2
Option 22 only
3
Option 23 only
4
Option 24 only
3
4
4
Returns the time amplitude for the mean carrier power measurement.
Returns the time amplitude for the power versus time measurement.
Returns the training sequence code in the GSM/EDGE analysis.
Returns the 3GPP uplink analysis measurement results.
:FORMat Commands
2-24
Define the data output format.
Table 2-16: :FORMat commands
HeaderDescription
:FORMat:BORDer (?)Selects the byte order of output data.
:FORMat[:DATA] (?)Selects the data format for output.
WCA230A & WCA280A Programmer Manual
:HCOPy Commands
:INITiate Commands
Command Groups
Control hardcopy of the screen.
Table 2-17: :HCOPy commands
HeaderDescription
:HCOPy:BACKgroundSelects the hardcopy background color.
:HCOPy:DESTinationSelects the hardcopy output destination.
:HCOPy[:IMMediate]Outputs the hardcopy to the specified printer.
Control data acquisition.
Table 2-18: :INITiate commands
HeaderDescription
:INITiate:CONTinuous (?)Determines whether to acquire data continuously.
:INITiate[:IMMediate]Starts data acquisition.
:INITiate:RESTartRestarts data acquisition.
:INPut Commands
Control the characteristics of the signal input.
Table 2-19: :INPut commands
HeaderDescription
:INPut:ALEVelAdjusts amplitude automatically for the best system performance.
:INPut:ATTenuation (?)Sets the input attenuation.
:INPut:ATTenuation:AUTO (?)Determines whether to set the input attenuation automatically.
:INPut:COUPling (?) (Option 03 only)Switches the input coupling in the IQ input mode.
:INPut:MIXer (?)Sets the mixer level.
:INPut:MLEVel (?)Sets the reference level.
WCA230A & WCA280A Programmer Manual
2-25
Command Groups
:INSTrument Commands
Sets the measurement mode for the analyzer.
Table 2-20: :INSTrument commands
HeaderDescription
:INSTrument:CATalog?Queries all the measurement modes that the analyzer has.
:INSTrument[:SELect]Selects the measurement mode.
:MMEMory Commands
Manipulates files residing on the internal hard disk or floppy disk.
Table 2-21: :MMEMory commands
HeaderDescription
:MMEMory:COPYCopies the contents of a file to another.
:MMEMory:DELeteDeletes a file.
:MMEMory:LOAD:CORRectionLoads the correction table from a file.
:MMEMory:LOAD:IQTLoads the IQ data from a file.
:MMEMory:LOAD:STATeLoads the analyzer settings from a file.
:MMEMory:LOAD:TRACeLoads trace data from a file.
:MMEMory:NAMESpecifies the file name for hard copy output.
:MMEMory:STORe:CORRectionStores an amplitude correction table in a file.
:MMEMory:STORe:IQTStores IQ data in a file.
:MMEMory:STORe:STABleStores a symbol table in a file.
:MMEMory:STORe:STATeStores the analyzer settings in a file.
:MMEMory:STORe:TRACeStores trace data in a file.
:PROGram Commands
Control macro programs.
Table 2-22: :PROGram commands
HeaderDescription
:PROGram:CATalog?Queries the list of macro programs.
:PROGram[:SELected]:DELete[:SELected]Deletes a macro program.
2-26
WCA230A & WCA280A Programmer Manual
Table 2-22: :PROGram commands (Cont.)
HeaderDescription
:PROGram[:SELected]:EXECuteRuns a macro program.
:PROGram[:SELected]:NAME (?)Specifies a macro program.
:PROGram:NUMBer (?)Sets numeric variables for a program.
:PROGram:STRing (?)Sets character variables for a program.
:READ Commands
The :READ commands acquire an input signal once in the single mode and
obtain the measurement results from that data.
If you want to fetch the measurement results from the data currently residing in
the memory without acquiring the input signal, use the :FETCh commands.
Command Groups
Table 2-23: :READ commands
HeaderDescription
:READ:AC3Gpp:ACLR?
:READ:ADEMod:AM?Returns the AM signal analysis results.
:READ:ADEMod:FM?Returns the FM signal analysis results.
:READ:ADEMod:PM?Returns the PM signal analysis results.
:READ:CCDF?Returns the CCDF measurement results.
:READ:DDEMod?Returns the digital modulation analysis measurement results.
:READ:GSMedge:MACCuracy?
:READ:GSMedge:MCPower?
:READ:GSMedge:MODulation?
:READ:GSMedge:PVTime?
:READ:GSMedge:SPECtrum:MODulation?
:READ:GSMedge:SPECtrum:SWITching?
:READ:GSMedge:SPURious?
:READ:GSMedge:SWITching?
:READ:GSMedge:TAMPlitude:MCPower?
:READ:GSMedge:TAMPlitude:PVTime?
:READ:SPECtrum?Returns spectrum waveform data.
:READ:SPECtrum:ACPower?Returns the ACPR measurement results.
:READ:SPECtrum:CFRequency?Returns the carrier frequency measurement results.
:READ:SPECtrum:CHPower?Returns the channel power measurement results.
1
2
2
2
2
2
2
2
2
2
2
Returns the 3GPP ACLR measurement results.
Returns the GSM/EDGE modulation accuracy measurement results.
Returns the GSM/EDGE mean carrier power measurement results.
Returns the GSM/EDGE modulation spectrum measurement results.
Returns the GSM/EDGE power versus time measurement results.
Returns the time amplitude for the modulation spectrum measurement.
Returns the time amplitude for the switching spectrum measurement.
Returns the GSM/EDGE spurious measurement results.
Returns the GSM/EDGE switching spectrum measurement results.
Returns the time amplitude for the mean carrier power measurement.
Returns the time amplitude for the power versus time measurement.
WCA230A & WCA280A Programmer Manual
2-27
Command Groups
Table 2-23: :READ commands (Cont.)
HeaderDescription
:READ:SPECtrum:CNRatio?Returns the C/N measurement results.
:READ:SPECtrum:EBWidth?Returns the emission bandwidth measurement results.
:READ:SPECtrum:OBWidth?Returns the OBW measurement results.
:READ:SPECtrum:SPURious?Returns the spurious signal measurement results.
:READ:TRANsient:FVTime?Returns the frequency vs. time measurement results.
:READ:TRANsient:IQVTime?Returns the I/Q level vs. time measurement results.
:READ:TRANsient:PVTime?Returns the power vs. time measurement results.
Runs the following three calibrations and returns the results indicating whether
they have ended normally.
RF gain calibration
Center offset calibration
DC offset calibration (if the measurement frequency band is the baseband)
This command is equivalent to the :CALibration[:ALL]? query command.
NOTE. The entire calibration process takes several minutes to several dozen
minutes. Wait for a response from a *CAL query. Every command you attempt to
send during this period is rejected.
Syntax
Arguments
Returns
Measurement Modes
Examples
Related Commands
*CLS (No Query Form)
*CAL?
None
<NR1>
0 indicates a normal end. For details of the error codes, refer to page 3–17.
All
*CAL?
runs a calibration and might return 0, indicating that the calibration has ended
normally.
:CALibration[:ALL]
Clears all the event status registers and queues used in the status/event reporting
structure. Refer to Section 3, Status and Events, for the register information.
2-38
Syntax
Arguments
*CLS
None
WCA230A & WCA280A Programmer Manual
IEEE Common Commands
Measurement Modes
Related Commands
*ESE (?)
Examples
Syntax
Arguments
All
*CLS
clears all the event status registers and queues.
*ESE, *ESR, *SRE, *STB?
Sets or queries the value of the Event Status Enable Register (ESER) used in the
status/event reporting structure. Refer to Section 3, Status and Events, for the
register information.
*ESE <value>
*ESE?
<value>::=<NR1> is a value in the range from 0 through 255. The binary bits of
the ESER are set according to this value.
Measurement Modes
Examples
Related Commands
*ESR? (Query Only)
Syntax
All
*ESE 145
sets the ESER to binary 10010001, which enables the PON, EXE, and OPC bits.
*ESE?
might return the string *ESE 184, showing that the ESER contains the binary
value 10111000.
*CLS, *ESR, *SRE, *STB?
Sets or queries the contents of the Standard Event Status Register (SESR) used
in the status/event reporting structure. The SESR is cleared after being read.
Refer to Section 3, Status and Events, for the register information.
*ESR?
WCA230A & WCA280A Programmer Manual
2-39
IEEE Common Commands
Arguments
Returns
Measurement Modes
Examples
Related Commands
*IDN? (Query Only)
Syntax
Arguments
None
<NR1> representing the contents of the SESR by a 0 to 255 decimal number.
All
*ESR?
might return the value 213, showing that the SESR contains binary 11010101.
*CLS, *ESE?, *SRE, *STB?
Returns the analyzer’s identification code.
*IDN?
None
Returns
Measurement Modes
Examples
The analyzer identification code in the following format:
Tektronix indicates that the manufacturer is Tektronix.
WCA2X0A is WCA230A or WCA280A, depending on the model.
<serial_number> is the serial number.
<firmware_version> is the firmware version.
All
*IDN?
might return Tektronix,WCA280A,J300101,V1.10 as the analyzer’s identification code.
2-40
WCA230A & WCA280A Programmer Manual
*OPC (?)
IEEE Common Commands
Generates the operation complete message in the Standard Event Status Register
(SESR) when all pending operations finish. The *OPC? query places the ASCII
character “1” into the output queue when all pending operations are finished. The
*OPC? response is not available to read until all pending operations finish.
The *OPC command allows you to synchronize the operation of the analyzer
with your application program. Refer to Synchronizing Execution on page 3–14
for the details.
Syntax
Arguments
Measurement Modes
*OPT? (Query Only)
Syntax
Arguments
Returns
*OPC
*OPC?
None
All
Queries the options installed in the analyzer.
*OPT?
None
The numbers of all the options installed in the analyzer, separated by commas.
If no options have been installed, 0 is returned.
Measurement Modes
Examples
WCA230A & WCA280A Programmer Manual
All
*OPT?
might return 02,22,23, indicating that Option 02, 22, and 23 are currently
installed in the analyzer.
2-41
IEEE Common Commands
*RST (No Query Form)
Restores the analyzer to the factory default settings. For the actual settings, refer
to Appendix C: Factory Initialization Settings. This command is equivalent to a
pair of commands :SYSTem:PRESet and *CLS that run successively.
The *RST command does not alter the following:
HThe state of the IEEE Std 488.1–1987 interface.
HThe selected IEEE Std 488.1–1987 address of the analyzer.
HMeasurement mode selected with the :INSTrument[:SELect] command
HCalibration data that affect device specifications.
HThe Output Queue.
HThe Service Request Enable Register setting.
HThe Standard Event Status Enable Register setting.
Measurement Modes
Related Commands
*SRE (?)
Syntax
Arguments
Examples
HThe Power-on status clear flag setting.
HStored settings.
*RST
None
All
*RST
resets the analyzer.
*CLS, :INSTrument[:SELect], :SYSTem:PRESet
Sets or queries the value of the Service Request Enable Register (SRER) used in
the status/event reporting structure. Refer to Section 3, Status and Events, for the
register information.
2-42
WCA230A & WCA280A Programmer Manual
IEEE Common Commands
Syntax
Arguments
Measurement Modes
Examples
Related Commands
*SRE <value>
*SRE?
<value>::=<NR1> is a value in the range from 0 to 255. The binary bits of the
SRER are set according to this value. Using an out-of-range value causes an
execution error.
All
*SRE 48
sets binary 00110000 in the SRER’s bits:
*SRE?
might return 32, indicating that binary value 00100000 has been set in the
SRER’s bits.
*CLS, *ESE, *ESR?, *STB?
*STB? (Query Only)
Syntax
Arguments
Returns
Measurement Modes
Examples
Related Commands
Returns the contents of the Status Byte Register (SBR) in the status/event
reporting structure using the Master Summary Status (MSS) bit.
Refer to Section 3, Status and Events, for the register information.
*STB?
None
<NR1> representing the contents of the SBR as a decimal number.
All
*STB?
might return 96, indicating that the SBR contains binary 0110 0000.
*CLS, *ESE, *ESR?, *SRE
WCA230A & WCA280A Programmer Manual
2-43
IEEE Common Commands
*TRG (No Query Form)
Generates a trigger signal.
This command is equivalent to the :INITiate[:IMMediate] command.
Syntax
Arguments
Measurement Modes
Examples
Related Commands
*TST? (Query Only)
*TRG
None
All
*TRG
generates a trigger signal.
:INITiate[:IMMediate]
Runs a self test and returns the result.
NOTE. The analyzer does not run any self test. It returns 0 whenever a *TST
command is sent.
Measurement Modes
Related Commands
2-44
Syntax
Arguments
Returns
*TST?
None
<NR1>. Always 0.
All
*CAL?, CALibration[:ALL]
WCA230A & WCA280A Programmer Manual
*WAI (No Query Form)
IEEE Common Commands
Prevents the analyzer from executing further commands or queries until all
pending operations finish. This command allows you to synchronize the
operation of the analyzer with your application program. For the details, refer to
Synchronizing Execution on page 3–14.
Syntax
Arguments
Measurement Modes
Related Commands
*WAI
None
All
*OPC
WCA230A & WCA280A Programmer Manual
2-45
IEEE Common Commands
2-46
WCA230A & WCA280A Programmer Manual
:ABORt Commands
Resets the trigger system and related actions such as data acquisition and
measurement.
Command Tree
HeaderParameter
:ABORt
WCA230A & WCA280A Programmer Manual
2-47
:ABORt Commands
:ABORt (No Query Form)
Resets the trigger system and related actions such as data acquisition and
measurement.
NOTE. You must have acquired data using the :INITiate:CONTinuous command
(refer to page 2–228) before you can execute the :ABORt command.
The command function depends on the acquisition mode as follows.
For single acquisition mode:
The :ABORt command forcibly stops data acquisition.
To stop the acquisition because the trigger does not occur in the single mode,
send this command:
For continuous acquisition mode:
The :ABORt command initiates a new session of data acquisition in the
continuous mode.
:INITiate:CONTinuous OFF
Syntax
Arguments
Measurement Modes
Examples
Related Commands
To stop the acquisition in the continuous mode, send this command:
:INITiate:CONTinuous OFF
:ABORt
None
All
:ABORt
resets the trigger system and related actions such as data acquisition and
measurement.
:INITiate:CONTinuous
2-48
WCA230A & WCA280A Programmer Manual
:CALCulate Commands
The :CALCulate commands control the marker and the display line. The views
are identified with :CALCulate<x> in the command header (see Figure 2–5).
For details on the marker and the display line, refer to the WCA230A &
WCA280A User Manual.
WCA230A & WCA280A Programmer Manual
2-49
:CALCulate Commands
Command Tree
HeaderParameter
:CALCulate<x>
:DLINe<y><numeric_value>
:STATe<boolean>
:MARKer<y>
:AOFF
:MAXimum
:MODEPOSition | DELTa
:PEAK
:HIGHer
:LEFT
:LOWer
:RIGHt
:PTHReshold<numeric_value>
:ROFF
[:SET]
:CENTer
:MEASurement
:RCURsor
[:STATe]<boolean>
:TOGGle
:TRACeMAIN | SUB
:X<numeric_value>
:Y<numeric_value>
:VLINe<y><numeric_value>
:STATe<boolean>
2-50
WCA230A & WCA280A Programmer Manual
:CALCulate<x>:DLINe<y> (?)
Sets or queries the vertical position of the horizontal line.
:CALCulate Commands
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CALCulate<x>:DLINe<y> <value>
:CALCulate<x>:DLINe<y>?
<value>::=<NRf> specifies the vertical position of the horizontal line.
Range: –200 to +100 dBm
SANORMAL, SASGRAM, SARTIME, SADL3G, SAUL3G
:CALCulate1:DLINe1 -20
positions Horizontal Line 1 at –20 dBm in View 1.
:CALCulate<x>:DLINe<y>:STATe
:CALCulate<x>:DLINe<y>:STATe (?)
Determines whether to turn on or off the horizontal line.
Syntax
:CALCulate<x>:DLINe<y>:STATe { OFF | ON|0|1}
:CALCulate<x>:DLINe<y>:STATe?
Arguments
Measurement Modes
Examples
OFF or 0 hides the horizontal line.
ON or 1 shows the horizontal line.
SANORMAL, SASGRAM, SARTIME, SADL3G, SAUL3G
:CALCulate1:DLINe2:STATe 1
shows Horizontal Line 2 in View 1.
:CALCulate<x>:MARKer<y>:AOFF (No Query Form)
Turns off all the markers of all the traces in the specified view.
WCA230A & WCA280A Programmer Manual
2-51
:CALCulate Commands
Syntax
Arguments
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>:AOFF
None
All
:CALCulate1:MARKer1:AOFF
turns off all the markers of all the traces in View 1.
:CALCulate<x>:MARKer<y>:MAXimum (No Query Form)
Positions the marker at the maximum point on the trace in the specified view.
Syntax
Arguments
Measurement Modes
:CALCulate<x>:MARKer<y>:MAXimum
None
All
Examples
:CALCulate1:MARKer1:MAXimum
positions the marker at the maximum point on the trace in View 1.
:CALCulate<x>:MARKer<y>:MODE (?)
Selects or queries the marker mode (position or delta) in the specified view.
Syntax
Arguments
Measurement Modes
:CALCulate<x>:MARKer<y>:MODE { POSition | DELTa }
:CALCulate<x>:MARKer<y>:MODE?
POSition selects the position marker mode, in which the marker measurement is
performed without the reference cursor. It works the same for both <y>=1 and 2.
DELTa selects the delta marker mode, in which the marker measurement is
performed with the reference cursor. The reference cursor is placed at the
position of the specified marker.
All
2-52
WCA230A & WCA280A Programmer Manual
:CALCulate Commands
Examples
:CALCulate1:MARKer1:MODE DELTa
selects the delta marker mode in View 1.
:CALCulate<x>:MARKer<y>:PEAK:HIGHer (No Query Form)
Moves the marker higher in amplitude to the next peak in the specified view.
Syntax
Arguments
Returns
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>:PEAK:HIGHer
None
If no peak exists, the error message “No Peak Found Error (202)” is returned.
All
:CALCulate1:MARKer1:PEAK:HIGHer
moves Marker 1 higher in amplitude to the next peak in View 1.
:CALCulate<x>:MARKer<y>:PEAK:LEFT (No Query Form)
Shifts the marker to the next peak on the left in the specified view.
Syntax
Arguments
Returns
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>:PEAK:LEFT
None
If no peak exists, the error message “No Peak Found Error (202)” is returned.
All
:CALCulate1:MARKer1:PEAK:LEFT
shifts the marker to the next peak on the left in View 1.
:CALCulate<x>:MARKer<y>:PEAK:LOWer (No Query Form)
Moves the marker lower in amplitude to the next peak in the specified view.
WCA230A & WCA280A Programmer Manual
2-53
:CALCulate Commands
Syntax
Arguments
Returns
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>:PEAK:LOWer
None
If no peak exists, error message “No Peak Found Error (202)” is returned.
All
:CALCulate1:MARKer1:PEAK:LOWer
moves Marker 1 lower in amplitude to the next peak in View 1.
:CALCulate<x>:MARKer<y>:PEAK:RIGHt (No Query Form)
Shifts the marker to the next peak on the right in the specified view.
Syntax
Arguments
:CALCulate<x>:MARKer<y>:PEAK:RIGHt
None
Returns
Measurement Modes
Examples
If no peak exists, the error message “No Peak Found Error (202)” is returned.
All
:CALCulate1:MARKer1:PEAK:RIGHt
shifts the marker to the next peak on the right in View 1.
:CALCulate<x>:MARKer<y>:PTHReshold (?)
Sets or queries the horizontal minimum jump of the marker for peak search in
the specified view.
Syntax
Arguments
:CALCulate<x>:MARKer<y>:PTHReshold <value>
:CALCulate<x>:MARKer<y>:PTHReshold?
<value>::=<NRf> sets the minimum jump of the marker for peak search.
Range: 1% to 20% of the span setting.
2-54
WCA230A & WCA280A Programmer Manual
:CALCulate Commands
Measurement Modes
Examples
All
:CALCulate1:MARKer1:PTHReshold 10kHz
sets the minimum jump of Marker 1 to 10 kHz for peak search.
:CALCulate<x>:MARKer<y>:ROFF (No Query Form)
Turns off the reference cursor in the specified view.
Syntax
Arguments
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>:ROFF
None
All
:CALCulate1:MARKer1:ROFF
turns off the reference cursor in View 1.
Related Commands
:CALCulate<x>:MARKer<y>[:SET]:RCURsor
:CALCulate<x>:MARKer<y>[:SET]:CENTer (No Query Form)
Sets the center frequency to the value at the marker position in the specified
view.
Syntax
Arguments
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>[:SET]:CENTer
None
SANORMAL, SASGRAM, SARTIME, SADL3G, SAUL3G
:CALCulate1:MARKer1:SET:CENTer
sets the center frequency to the value at the marker position in View 1.
:CALCulate<x>:MARKer<y>[:SET]:MEASurement (No Query Form)
Defines the measurement position using the marker(s) in the specified view.
WCA230A & WCA280A Programmer Manual
2-55
:CALCulate Commands
NOTE. This command is available in a view that represents time along the
horizontal axis.
The function is different between the marker modes as follows:
HFor the position marker mode:
Sets the current position of the specified marker to the measurement start
position.
HFor the delta marker mode:
Sets the current positions of the specified marker and the reference cursor to
the measurement start and stop positions.
The marker mode is selected with the :CALCulate<x>:MARKer<y>:MODE
command (refer to page 2–52).
defines the measurement position using the marker in View 1.
:CALCulate<x>:MARKer<y>:MODE
:CALCulate<x>:MARKer<y>[:SET]:RCURsor (No Query Form)
Displays the reference cursor at the marker position in the specified view.
Syntax
Arguments
:CALCulate<x>:MARKer<y>[:SET]:RCURsor
None
Measurement Modes
2-56
Examples
All
:CALCulate1:MARKer1:SET:RCURsor
displays the reference cursor in View 1.
WCA230A & WCA280A Programmer Manual
:CALCulate Commands
Related Commands
:CALCulate<x>:MARKer<y>:ROFF
:CALCulate<x>:MARKer<y>[:STATe] (?)
Determines whether to turn on or off the marker(s) in the specified view.
Syntax
Arguments
Measurement Modes
:CALCulate<x>:MARKer<y>[:STATe] { OFF | ON|0|1}
:CALCulate<x>:MARKer<y>[:STATe]?
OFF or 0 hides the marker(s). If you have selected the delta marker mode, both
the main and delta markers will be turned off.
ON or 1 shows the marker(s). If you have selected the delta marker mode, both
the main and delta markers will be turned on.
To select a marker mode, use :CALCulate<x>:MARKer<y>:MODE.
All
Examples
Related Commands
:CALCulate1:MARKer1:STATe ON
enables Marker 1 in View 1.
:CALCulate<x>:MARKer<y>:MODE
:CALCulate<x>:MARKer<y>:TOGGle (No Query Form)
Replaces the marker and the reference cursor with each other in the specified
view.
Syntax
Arguments
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>:TOGGle
None
All
:CALCulate1:MARKer1:TOGGle
replaces Marker 1 and the reference cursor with each other in View 1.
WCA230A & WCA280A Programmer Manual
2-57
:CALCulate Commands
:CALCulate<x>:MARKer<y>:TRACe (?)
Selects the trace to place the marker in the specified view.
The query command returns the name of the trace on which the marker is
currently placed.
Syntax
Arguments
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>:TRACe { MAIN | SUB }
:CALCulate<x>:MARKer<y>:TRACe?
MAIN places the specified marker on Trace 1 (displayed in yellow on screen).
SUB places the specified marker on Trace 2 (displayed in green on screen).
All
:CALCulate1:MARKer1:TRACe SUB
places Marker 1 on Trace 2 in View 1.
:CALCulate<x>:MARKer<y>:X (?)
Sets or queries the horizontal position of the marker in the specified view.
Syntax
:CALCulate<x>:MARKer<y>:X <param>
:CALCulate<x>:MARKer<y>:X?
2-58
Arguments
<param>::=<NRf> specifies the horizontal marker position.
The parameter value is different between the marker modes as follows:
HFor the position marker mode:
Sets the absolute position of the specified marker.
HFor the delta marker mode:
Sets the relative position of the specified marker from the reference cursor.
The marker mode is selected with the :CALCulate<x>:MARKer<y>:MODE
command (refer to page 2–52).
The valid setting range depends on the display format. Refer to Table D–1 in
Appendix D.
WCA230A & WCA280A Programmer Manual
:CALCulate Commands
Measurement Modes
Examples
Related Commands
All
:CALCulate1:MARKer1:X 800MHz
places Marker 1 at 800 MHz in View 1 when the horizontal axis represents
frequency.
:CALCulate<x>:MARKer<y>:MODE
:CALCulate<x>:MARKer<y>:Y (?)
Sets or queries the vertical position of the marker in the specified view.
NOTE. The setting command is valid on the spectrogram view displayed in the
Real Time S/A (real-time spectrum analysis) mode and in the overview of the
Demod (modulation analysis) and the Time (time analysis) modes. If the
command is executed in the other view, the error message “Execution Error”
(–200) is returned. The query is available in all views.
Syntax
Arguments
Measurement Modes
:CALCulate<x>:MARKer<y>:Y <param>
:CALCulate<x>:MARKer<y>:Y?
<param>::=<NRf> specifies the vertical marker position.
The parameter value is different between the marker modes as follows:
HFor the position marker mode:
Sets the absolute position of the specified marker.
HFor the delta marker mode:
Sets the relative position of the specified marker from the reference cursor.
The marker mode is selected with the :CALCulate<x>:MARKer<y>:MODE
command (refer to page 2–52).
For the setting range, refer to Table D–1 in Appendix D.
SARTIME, DEMADEM, DEMDDEM, DEMDL3G, DEMUL3G, TIMCCDF, and TIMTRAN for
setting. All modes for query.
WCA230A & WCA280A Programmer Manual
2-59
:CALCulate Commands
Examples
Related Commands
:CALCulate1:MARKer1:Y -20
places the first marker at frame #–20 in View 1 (spectrogram).
:CALCulate2:MARKer1:Y?
might return -34.28 indicating the first marker readout is –34.28 dBm in View 2
(spectrum).
:CALCulate<x>:MARKer<y>:MODE
:CALCulate<x>:VLINe<y> (?)
Sets or queries the horizontal position of the vertical line.
Syntax
Arguments
:CALCulate<x>:VLINe<y> <value>
:CALCulate<x>:VLINe<y>?
<value>::=<NRf> specifies the horizontal position of the vertical line.
Range: 0 Hz to 3 GHz for WCA230A, or 8 GHz for WCA280A.
Measurement Modes
Examples
Related Commands
SANORMAL, SASGRAM, SARTIME, SADL3G, SAUL3G
:CALCulate1:VLINe1 800MHz
sets the horizontal position of Vertical Line 1 to 800 MHz.
:CALCulate<x>:VLINe<y>:STATe
:CALCulate<x>:VLINe<y>:STATe (?)
Determines whether to turn on or off the vertical line.
Syntax
Arguments
:CALCulate<x>:VLINe<y>:STATe { OFF | ON|0|1}
:CALCulate<x>:VLINe<y>:STATe?
OFF or 0 hides the vertical line.
ON or 1 shows the vertical line.
Measurement Modes
2-60
SANORMAL, SASGRAM, SARTIME, SADL3G, SAUL3G
WCA230A & WCA280A Programmer Manual
:CALCulate Commands
Examples
:CALCulate1:VLINe1:STATe ON
shows Vertical Line 1 in View 1.
WCA230A & WCA280A Programmer Manual
2-61
:CALCulate Commands
2-62
WCA230A & WCA280A Programmer Manual
:CALibration Commands
The :CALibration commands run calibrations on the analyzer.
For details on calibrations, refer to the WCA230A & WCA280A User Manual.
Command Tree
HeaderParameter
:CALibration
[:ALL]
:AUTO
:DATA
:DEFault
:OFFSet
:BASebanddc
:CENTer
:IQINput (Option 03 only)
:RF
WCA230A & WCA280A Programmer Manual
2-63
:CALibration Commands
:CALibration[:ALL] (?)
Runs the following three calibrations:
RF gain calibration
Center offset calibration
DC offset calibration (if the measurement frequency band is the baseband)
The :CALibration[:ALL]? query command runs these calibrations and returns the
results. This command is equivalent to the *CAL? query command.
Syntax
Arguments
Returns
Measurement Modes
Examples
Related Commands
:CALibration:AUTO (?)
:CALibration[:ALL]
:CALibration[:ALL]?
None
<NR1>
0 indicates a normal end. For details of the error codes, refer to page 3–17.
All
:CALibration:ALL
runs all calibrations.
*CAL?
2-64
Syntax
Arguments
Determines whether to run the RF gain calibration automatically.
:CALibration:AUTO { OFF | ON|0|1}
:CALibration:AUTO?
OFF or 0 specifies that the analyzer does not run the RF gain calibration
automatically. Use the :CALibration:RF command to run the RF gain calibration.
ON or 1 specifies that the analyzer runs the RF gain calibration automatically.
WCA230A & WCA280A Programmer Manual
:CALibration Commands
Measurement Modes
Examples
Related Commands
All
:CALibration:AUTO ON
specifies that the analyzer runs the RF gain calibration automatically.
:CALibration:RF
:CALibration:DATA:DEFault (No Query Form)
Restores the calibration data to the factory defaults.
Syntax
Arguments
Measurement Modes
Examples
:CALibration:DATA:DEFault
None
All
:CALibration:DATA:DEFault
restores the calibration data to the factory defaults.
:CALibration:OFFSet:BASebanddc (?)
Runs the baseband DC offset calibration. The query version of this command
runs the calibration and, if it ends normally, returns 0.
NOTE. This command is available when the analyzer operates in the baseband
(DC to 20 MHz). The frequency setting must satisfy the following condition:
(center frequency) + (span)/2 v 17.5 MHz
Syntax
Arguments
Returns
:CALibration:OFFSet:BASebanddc
:CALibration:OFFSet:BASebanddc?
None
<NR1>
WCA230A & WCA280A Programmer Manual
2-65
:CALibration Commands
0 indicates a normal end. For details of the error codes, refer to page 3–17.
Measurement Modes
Examples
All
:CALibration:OFFSet:BASebanddc
runs the baseband DC offset calibration.
:CALibration:OFFSet:CENTer (?)
Runs the center offset calibration. The query version of this command runs the
calibration and, if it ends normally, returns 0.
Syntax
Arguments
Returns
:CALibration:OFFSet:CENTer
:CALibration:OFFSet:CENTer?
None
<NR1>
0 indicates a normal end. For details of the error codes, refer to page 3–17.
Measurement Modes
Examples
All
:CALibration:OFFSet:CENTer
runs the center offset calibration.
:CALibration:OFFSet:IQINput (?)
Option 03 Only
Runs the IQ input offset calibration. The query version of this command runs the
calibration and, if it ends normally, returns 0.
NOTE. Before running the IQ input offset calibration, connect the I/Q signal to
the I/Q input connector on the rear panel and set the I/Q signal level to 0.
To run this command, you must have selected IQ in the [:SENSe]:FEED
command.
2-66
WCA230A & WCA280A Programmer Manual
:CALibration Commands
Syntax
Arguments
Returns
Measurement Modes
Examples
Related Commands
:CALibration:RF (?)
:CALibration:OFFSet:IQINput
:CALibration:OFFSet:IQINput?
None
<NR1>
0 indicates a normal end. For details of the error codes, refer to page 3–17.
All
:CALibration:OFFSet:IQINput
runs the IQ input offset calibration.
[:SENSe]:FEED
Syntax
Arguments
Returns
Measurement Modes
Examples
Related Commands
Runs the RF gain calibration. The query version of this command runs the
calibration and, if it ends normally, returns 0.
:CALibration:RF
:CALibration:RF?
None
<NR1>
0 indicates a normal end. For details of the error codes, refer to page 3–17.
All
:CALibration:RF
runs the RF gain calibration.
:CALibration:AUTO
WCA230A & WCA280A Programmer Manual
2-67
:CALibration Commands
2-68
WCA230A & WCA280A Programmer Manual
:CONFigure Commands
The :CONFigure commands set up the analyzer to the default settings for the
specified measurement.
Sets up the analyzer to the default settings for the 3GPP adjacent channel leakage
power ratio (ACLR) measurement. Running this command is equivalent to
pressing the following front panel keys:
DEMOD key " Standard... side key " { W-CDMA-DL | W-CDMA-UL }
side key " PRESET key " ACLR side key
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CONFigure:AC3Gpp
None
SADL3G, SAUL3G
:CONFigure:AC3Gpp
sets up the analyzer to the default settings for 3GPP ACLR measurement.
:INSTrument[:SELect]
:CONFigure:ADEMod:AM (No Query Form)
Sets up the analyzer to the default settings for AM signal analysis.
Running this command is equivalent to pressing the following front panel keys:
DEMOD key " Analog Demod side key " PRESET key " MEASURE key
" AM Demod side key
Measurement Modes
Related Commands
2-70
Syntax
Arguments
Examples
:CONFigure:ADEMod:AM
None
DEMADEM
:CONFigure:ADEMod:AM
sets up the analyzer to the default settings for AM signal analysis.
:INSTrument[:SELect]
WCA230A & WCA280A Programmer Manual
:CONFigure:ADEMod:FM (No Query Form)
Sets up the analyzer to the default settings for FM signal analysis.
Running this command is equivalent to pressing the following front panel keys:
DEMOD key " Analog Demod side key " PRESET key " MEASURE key
" FM Demod side key
:CONFigure Commands
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CONFigure:ADEMod:FM
None
DEMADEM
:CONFigure:ADEMod:FM
sets up the analyzer to the default settings for FM signal analysis.
:INSTrument[:SELect]
:CONFigure:ADEMod:PM (No Query Form)
Sets up the analyzer to the default settings for PM signal analysis.
Running this command is equivalent to pressing the following front panel keys:
DEMOD key " Analog Demod side key " PRESET key " MEASURE key
" PM Demod side key
Syntax
Arguments
Measurement Modes
Examples
Related Commands
WCA230A & WCA280A Programmer Manual
:CONFigure:ADEMod:PM
None
DEMADEM
:CONFigure:ADEMod:PM
sets up the analyzer to the default settings for PM signal analysis.
:INSTrument[:SELect]
2-71
:CONFigure Commands
:CONFigure:CCDF (No Query Form)
Sets up the analyzer to the default settings for CCDF measurement.
Running this command is equivalent to pressing the following front panel keys:
TIME key " CCDF side key " PRESET key " CCDF side key
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CONFigure:CCDF
None
TIMCCDF
:CONFigure:CCDF
sets up the analyzer to the default settings for CCDF measurement.
:INSTrument[:SELect]
:CONFigure:DDEMod (No Query Form)
Sets up the analyzer to the default settings for digital modulation analysis.
Running this command is equivalent to pressing the following front panel keys:
DEMOD key " Digital Demod side key " PRESET key
Syntax
:CONFigure:DDEMod
Measurement Modes
Related Commands
2-72
Arguments
Examples
None
DEMDDEM
:CONFigure:DDEMod
sets up the analyzer to the default settings for digital modulation analysis.
:INSTrument[:SELect]
WCA230A & WCA280A Programmer Manual
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.