Licensed software products are owned by Tektronix 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 Technical 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 FAR 52.227-19, as applicable.
Tektronix 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.
Tektronix Japan, Ltd., Shinagawa Intercity Building B 6th Floor, 2-15-2 Konan, Minato-ku, Tokyo 108-6106 Japan
Tektronix, Inc., P.O. Box 500, Beaverton, OR 97077
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
Windows and Windows 98 are trademarks of Microsoft Corporation.
Hardware Warranty
Tektronix warrants that the products that it manufactures and sells will be free from defects in materials and workmanship
for a period of one (1) year from the date of shipment. If a product proves defective during this warranty period, Tektronix,
at its option, either will repair the defective product without charge for parts and labor, or will provide a replacement in
exchange for the defective product.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of the
warranty period and make suitable arrangements for the performance of service. Customer shall be responsible for
packaging and shipping the defective product to the service center designated by Tektronix, with shipping charges prepaid.
Tektronix shall pay for the return of the product to Customer if the shipment is to a location within the country in which the
Tektronix service center is located. Customer shall be responsible for paying all shipping charges, duties, taxes, and any
other charges for products returned to any other locations.
This warranty shall not apply to any defect, failure or damage caused by improper use or improper or inadequate
maintenance and care. Tektronix shall not be obligated to furnish service under this warranty a) to repair damage resulting
from attempts by personnel other than Tektronix representatives to install, repair or service the product; b) to repair
damage resulting from improper use or connection to incompatible equipment; c) to repair any damage or malfunction
caused by the use of non-Tektronix supplies; or d) to service a product that has been 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 IN LIEU OF ANY OTHER WARRANTIES, EXPRESS OR
IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. TEKTRONIX’ RESPONSIBILITY TO
REPAIR OR REPLACE DEFECTIVE PRODUCTS IS THE SOLE AND EXCLUSIVE REMEDY PROVIDED TO
THE CUSTOMER FOR BREACH OF THIS WARRANTY. TEKTRONIX AND ITS VENDORS WILL NOT BE
LIABLE FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES IRRESPECTIVE
OF WHETHER TEKTRONIX OR THE VENDOR HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH
DAMAGES.
Software Warranty
Tektronix warrants that the media on which this software product is furnished and the encoding of the programs on the
media will be free from defects in materials and workmanship for a period of three (3) months from the date of shipment.
If a medium or encoding proves defective during the warranty period, Tektronix will provide a replacement in exchange
for the defective medium. Except as to the media on which this software product is furnished, this software product is
provided “as is” without warranty of any kind, either express or implied. Tektronix does not warrant that the functions
contained in this software product will meet Customer’s requirements or that the operation of the programs will be
uninterrupted or error–free.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of the
warranty period. If Tektronix is unable to provide a replacement that is free from defects in materials and workmanship
within a reasonable time thereafter, Customer may terminate the license for this software product and return this software
product and any associated materials for credit or refund.
THIS WARRANTY IS GIVEN BY TEKTRONIX IN LIEU OF ANY OTHER WARRANTIES, EXPRESS OR
IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. TEKTRONIX’ RESPONSIBILITY TO
REPLACE DEFECTIVE MEDIA OR REFUND CUSTOMER’S PAYMENT IS THE SOLE AND EXCLUSIVE
REMEDY PROVIDED TO THE CUSTOMER FOR BREACH OF THIS WARRANTY. TEKTRONIX AND ITS
VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX OR THE VENDOR HAS ADVANCE NOTICE OF
THE POSSIBILITY OF SUCH DAMAGES.
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 and 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
ix
Preface
x
WCA230A & WCA280A Programmer Manual
Getting Started
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 programming 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 and 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 off.
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.
When the analyzer is disconnected from the bus, all the communication
processes with the controller are interrupted.
WCA230A & WCA280A Programmer Manual
1-7
Getting Started
1-8
WCA230A & WCA280A Programmer Manual
Syntax and Commands
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–35, 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 WCA200 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 an octal or hexadecimal value even though
the parameter type is defined as NR1.
4
Defined in ANSI/IEEE 488.2 as String Response Data."
2-4
WCA230A & WCA280A Programmer Manual
Command Syntax
SCPIĆdefined Parameters. In addition to the ANSI/IEEE 488.2-1987-defined
parameters, WCA200 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–259) supports
UP and DOWN for the numeric parameters. The increment/decrement of
UP/DOWN is determined by one of these commands:
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 the message is
complete. 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 Systeme International
d’Unites standard.) For example, you can use the input format 200 mV or
1.0 MHz instead of 200.0E–3 or 1.0E+6, respectively, to specify voltage or
frequency.
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 the WCA200 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–35.
The WCA200 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.
For the conventions of notation in this manual, refer to Command Syntax on
page 2-1 and following pages.
WCA230A & WCA280A Programmer Manual
2-13
Command Groups
Measurement Mode
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–171) using one of the mnemonics listed below:
:DISPlay:WAVeform:X[:SCALe]:OFFSet (?)Sets the minimum horizontal, or time, value (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 (bottom end).
:DISPlay:WAVeform:Y[:SCALe]:PDIVision (?)Sets the vertical, or amplitude, scale.
2-22
WCA230A & WCA280A Programmer Manual
Command Groups
: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:ADEMod:AM?Returns the AM signal analysis results in time series.
:FETCh:ADEMod:AM:RESult?Returns the AM signal analysis results.
:FETCh:ADEMod:FM?Returns the FM signal analysis results in time series.
:FETCh:ADEMod:FM:RESult?Returns the FM signal analysis results.
:FETCh:ADEMod:PM?Returns the PM signal analysis results in time series.
:FETCh:CCDF?Returns the CCDF measurement results.
:FETCh:DDEMod?Returns the digital modulation analysis measurement results.
:FETCh:DISTribution:CCDF?Returns the CCDF trace data.
:FETCh:SPECtrum?Returns spectrum waveform data.
:FETCh:OVIew?Returns the maximum and minimum of waveform on the overview.
: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.
WCA230A & WCA280A Programmer Manual
2-23
Command Groups
:FORMat Commands
:HCOPy Commands
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.
Control hardcopy of the screen.
Table 2-17: :HCOPy commands
:INITiate 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.
2-24
WCA230A & WCA280A Programmer Manual
Command Groups
: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.
: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.
WCA230A & WCA280A Programmer Manual
2-25
Command Groups
: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.
: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.
2-26
WCA230A & WCA280A Programmer Manual
Command Groups
: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.
Table 2-23: :READ commands
HeaderDescription
:READ:ADEMod:AM?Returns the AM signal analysis results in time series.
:READ:ADEMod:AM:RESult?Returns the AM signal analysis results.
:READ:ADEMod:FM?Returns the FM signal analysis results in time series.
:READ:ADEMod:FM:RESult?Returns the FM signal analysis results.
:READ:ADEMod:PM?Returns the PM signal analysis results in time series.
:READ:CCDF?Returns the CCDF measurement results.
:READ:DDEMod?Returns the digital modulation analysis measurement results.
:READ:DISTribution:CCDF?Returns the CCDF trace data.
:READ:OVIew?Returns the maximum and minimum of waveform on the overview.
: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.
: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.
:TRACe<x>|:DATA<x>:AVERage:COUNt (?)Sets the number of traces to combine for averaging.
:TRACe<x>|:DATA<x>:DDETector (?)Selects the display detector.
:TRACe<x>|:DATA<x>:MODE (?)Selects the way to display the traces.
2-32
WCA230A & WCA280A Programmer Manual
Command Groups
:TRIGger Commands
Set up the trigger.
Table 2-28: :TRIGger commands
HeaderDescription
:TRIGger[:SEQuence]:LEVel:IF (?)Sets the IF trigger level.
:TRIGger[:SEQuence]:LEVel:IQFRequency (?)Sets the IQ frequency trigger level (Option 02 only).
:TRIGger[:SEQuence]:LEVel:IQTime (?)Sets the IQ time trigger level (Option 02 only).
:TRIGger[:SEQuence]:MODE (?)Selects the trigger mode.
:TRIGger[:SEQuence]:MPOSition?Queries the trigger occurrence point in one block data on the memory.
:TRIGger[:SEQuence]:OPOSition?Queries the trigger output point.
:TRIGger[:SEQuence]:POSition (?)Sets the trigger position.
:TRIGger[:SEQuence]:SLOPe (?)Selects the trigger slope.
:TRIGger[:SEQuence]:SOURce (?)Selects the trigger source.
WCA230A & WCA280A Programmer Manual
2-33
Command Groups
General Programming Procedure
You should generally use the following procedure to script a program:
1. Setting the measurement mode
Using an :INSTrument command, select a measurement mode to set the
basic conditions.
[Example] :INSTrument:SELect "SANORMAL"
Selects the normal spectrum analysis mode to set the basic conditions.
2. Setting the measurement item
Using a :CONFigure command, select a measurement item to set up the
analyzer to the defaults.
[Example] :CONFigure:SPECtrum:CHPower
Sets up the analyzer to the channel power measurement defaults.
3. Detailed settings
Use :SENSe commands to set details for the measurement session.
[Example] :SENSe:CHPower:BWIDth:INTegration 3MHz
Sets the channel power measurement range to 3 MHz.
4. Acquiring data
Use an :INITiate or :ABORt command to initiate or stop data acquisition.
[Example] :INITiate:CONTinuous ON
Initiates data acquisition in continuous mode.
To save or load the acquired data and settings, use an :MMEMory command.
[Example] :MMEMory:STORe:IQT "DATA1"
Saves the acquired data in file DATA1.IQT.
5. Obtaining the measurement results
Use a :FETCh or :READ command to obtain the measurement results.
[Example] :FETCh:SPECtrum:CHPower?
Returns the channel power measurement results.
6. Display
Use :DISPlay commands to set the display-related conditions.
[Example] :DISPlay:SPECtrum:X:SCALe:OFFSet 800MHz
Sets 800 MHz for the minimum (left) edge of the horizontal axis in the
spectrum view.
NOTE. A menu item grays out on the screen when the setting is prohibited or
unavailable. If you run the GPIB command corresponding to this menu item, an
execution error occurs. For example, when no waveform is displayed on the
screen, the scale-related commands are invalid.
2-34
Also refer to Chapter 4, Programming Examples.
Appendix C lists the default settings of the commands.
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
*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]
2-36
WCA230A & WCA280A Programmer Manual
*CLS (No Query Form)
IEEE Common Commands
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.
Measurement Modes
Related Commands
*ESE (?)
Syntax
Arguments
Examples
Syntax
*CLS
None
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?
Arguments
Measurement Modes
Examples
Related Commands
WCA230A & WCA280A Programmer Manual
<value>::=<NR1> is a value in the range from 0 through 255. The binary bits of
the ESER are set according to this value.
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?
2-37
IEEE Common Commands
*ESR? (Query Only)
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.
Syntax
Arguments
Returns
Measurement Modes
Examples
Related Commands
*ESR?
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?
2-38
WCA230A & WCA280A Programmer Manual
*IDN? (Query Only)
IEEE Common Commands
Returns the analyzer identification code.
Syntax
Arguments
Returns
Measurement Modes
Examples
*IDN?
None
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,1.20 as the analyzer identification
code.
*OPC (?)
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
WCA230A & WCA280A Programmer Manual
*OPC
*OPC?
None
All
2-39
IEEE Common Commands
*OPT? (Query Only)
Queries the options installed in the analyzer.
Syntax
Arguments
Returns
Measurement Modes
Examples
*OPT?
None
The numbers of all the options installed in the analyzer, separated by commas.
If no options have been installed, 0 is returned.
All
*OPT?
might return 02,03,21, indicating that Option 02, 03, and 21 are currently
installed in the analyzer.
2-40
WCA230A & WCA280A Programmer Manual
*RST (No Query Form)
IEEE Common Commands
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.
Syntax
Arguments
Measurement Modes
Examples
Related Commands
HThe Power-on status clear flag setting.
HStored settings.
*RST
None
All
*RST
resets the analyzer.
*CLS, :INSTrument[:SELect], :SYSTem:PRESet
WCA230A & WCA280A Programmer Manual
2-41
IEEE Common Commands
*SRE (?)
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.
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?
2-42
WCA230A & WCA280A Programmer Manual
*STB? (Query Only)
IEEE Common 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.
Syntax
Arguments
Returns
Measurement Modes
Examples
Related Commands
*TRG (No Query Form)
*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
Generates a trigger signal.
This command is equivalent to the :INITiate[:IMMediate] command.
Syntax
Arguments
Measurement Modes
Examples
Related Commands
WCA230A & WCA280A Programmer Manual
*TRG
None
All
*TRG
generates a trigger signal.
:INITiate[:IMMediate]
2-43
IEEE Common Commands
*TST? (Query Only)
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.
Syntax
Arguments
Returns
Measurement Modes
Related Commands
*WAI (No Query Form)
Syntax
*TST?
None
<NR1>. Always 0.
All
*CAL?, CALibration[:ALL]
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.
*WAI
Measurement Modes
Related Commands
2-44
Arguments
None
All
*OPC
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-45
: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–160) 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-46
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).
:CALCulate1: View 1
:CALCulate2: View 2 (NOTE: currently not used)
:CALCulate3: View 3
:CALCulate4: View 4
View 1
View 1
May be View 3 or 4, depending on the setting
in the :DISPlay[:VIEW]:FORMat command.
For details on the marker and the display line, refer to the WCA230A and
WCA280A User Manual.
WCA230A & WCA280A Programmer Manual
2-47
: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>
:T<numeric_value>
:TOGGle
:TRACeMAIN | SUB
:X<numeric_value>
:Y<numeric_value>
:VLINe<y><numeric_value>
:STATe<boolean>
2-48
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
All S/A modes
: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
WCA230A & WCA280A Programmer Manual
OFF or 0 hides the horizontal line.
ON or 1 shows the horizontal line.
All S/A modes
:CALCulate1:DLINe2:STATe 1
shows Horizontal Line 2 in View 1.
2-49
:CALCulate Commands
:CALCulate<x>:MARKer<y>:AOFF (No Query Form)
Turns off all the markers of all the traces in the specified view.
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
2-50
Examples
:CALCulate1:MARKer1:MAXimum
positions the marker at the maximum point on the trace in View 1.
WCA230A & WCA280A Programmer Manual
:CALCulate<x>:MARKer<y>:MODE (?)
Selects or queries the marker mode (position or delta) in the specified view.
:CALCulate Commands
Syntax
Arguments
Measurement Modes
Examples
: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
: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
WCA230A & WCA280A Programmer Manual
: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.
2-51
:CALCulate Commands
: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.
Syntax
Arguments
:CALCulate<x>:MARKer<y>:PEAK:LOWer
None
Measurement Modes
2-52
Returns
Examples
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.
WCA230A & WCA280A Programmer Manual
:CALCulate<x>:MARKer<y>:PEAK:RIGHt (No Query Form)
Shifts the marker to the next peak on the right in the specified view.
:CALCulate Commands
Syntax
Arguments
Returns
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>:PEAK:RIGHt
None
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
:CALCulate<x>:MARKer<y>:PTHReshold <value>
:CALCulate<x>:MARKer<y>:PTHReshold?
Arguments
Measurement Modes
Examples
WCA230A & WCA280A Programmer Manual
<value>::=<NRf> sets the minimum jump of the marker for peak search.
Range: 1% to 20% of the span setting.
All
:CALCulate1:MARKer1:PTHReshold 10kHz
sets the minimum jump of Marker 1 to 10 kHz for peak search.
2-53
:CALCulate Commands
:CALCulate<x>:MARKer<y>:ROFF (No Query Form)
Turns off the reference cursor in the specified view.
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CALCulate<x>:MARKer<y>:ROFF
None
All
:CALCulate1:MARKer1:ROFF
turns off the reference cursor in View 1.
: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
:CALCulate<x>:MARKer<y>[:SET]:CENTer
Measurement Modes
2-54
Arguments
Examples
None
All S/A modes
:CALCulate1:MARKer1:SET:CENTer
sets the center frequency to the value at the marker position in View 1.
WCA230A & WCA280A Programmer Manual
:CALCulate Commands
:CALCulate<x>:MARKer<y>[:SET]:MEASurement (No Query Form)
Defines the measurement position using the marker(s) in the specified view.
NOTE. This command is available in a view that represents time along the
horizontal axis.
The function varies 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–51).
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CALCulate<x>:MARKer<y>[:SET]:MEASurement
None
All Demod modes, all Time modes
:CALCulate1:MARKer1:SET:MEASurement
defines the measurement position using the marker in View 1.
:CALCulate<x>:MARKer<y>:MODE
WCA230A & WCA280A Programmer Manual
2-55
:CALCulate Commands
:CALCulate<x>:MARKer<y>[:SET]:RCURsor (No Query Form)
Displays the reference cursor at the marker position in the specified view.
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CALCulate<x>:MARKer<y>[:SET]:RCURsor
None
All
:CALCulate1:MARKer1:SET:RCURsor
displays the reference cursor in View 1.
: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
:CALCulate<x>:MARKer<y>[:STATe] { OFF | ON|0|1}
:CALCulate<x>:MARKer<y>[:STATe]?
Measurement Modes
Related Commands
2-56
Arguments
Examples
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
:CALCulate1:MARKer1:STATe ON
enables Marker 1 in View 1.
:CALCulate<x>:MARKer<y>:MODE
WCA230A & WCA280A Programmer Manual
:CALCulate<x>:MARKer<y>:T (?)
Sets or queries the time position of the marker in the specified view.
NOTE. This command is valid in the eye diagram and the constellation view.
:CALCulate Commands
Syntax
Arguments
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>:T <time>
:CALCulate<x>:MARKer<y>:T?
<time>::=<NRf> sets the time position of the marker in seconds.
For the setting range, refer to Table D–1 in Appendix D.
All Demod modes except DEMADEM
:CALCulate4:MARKer1:T -1.5ms
places Marker 1 at –1.5 ms in View 4 of the eye diagram.
:CALCulate<x>:MARKer<y>:TOGGle (No Query Form)
Replaces the marker and the reference cursor with each other in the specified
view.
Syntax
:CALCulate<x>:MARKer<y>:TOGGle
Arguments
Measurement Modes
Examples
WCA230A & WCA280A Programmer Manual
None
All
:CALCulate1:MARKer1:TOGGle
replaces Marker 1 and the reference cursor with each other in View 1.
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.
2-58
WCA230A & WCA280A Programmer Manual
:CALCulate<x>:MARKer<y>:X (?)
Sets or queries the horizontal position of the marker in the specified view.
NOTE. For the eye diagram or the constellation view, only query is available.
For the constellation view, the returned value means an amplitude.
:CALCulate Commands
Syntax
Arguments
Measurement Modes
Examples
:CALCulate<x>:MARKer<y>:X <param>
:CALCulate<x>:MARKer<y>:X?
<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–51).
The valid setting range depends on the display format. Refer to Table D–1 in
Appendix D.
All
:CALCulate1:MARKer1:X 800MHz
places Marker 1 at 800 MHz in View 1 when the horizontal axis represents
frequency.
Related Commands
WCA230A & WCA280A Programmer Manual
:CALCulate<x>:MARKer<y>:MODE
2-59
:CALCulate Commands
:CALCulate<x>:MARKer<y>:Y (?)
Sets or queries the vertical position of the marker in the specified view.
NOTE. The setting command is valid in 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 other views, the error message “Execution Error”
(–200) is returned.
The query is available in all views. For the constellation view, the returned value
means a phase.
Syntax
Arguments
Measurement Modes
Examples
: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–51).
For the setting range, refer to Table D–1 in Appendix D.
SARTIME, all Demod modes, and all Time modes for setting.
All modes for query.
:CALCulate1:MARKer1:Y -20
places the first marker at frame #–20 in View 1 (spectrogram).
2-60
Related Commands
: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
WCA230A & WCA280A Programmer Manual
:CALCulate<x>:VLINe<y> (?)
Sets or queries the horizontal position of the vertical line.
:CALCulate Commands
Syntax
Arguments
Measurement Modes
Examples
Related Commands
: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.
All S/A modes
: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
:CALCulate<x>:VLINe<y>:STATe { OFF | ON|0|1}
:CALCulate<x>:VLINe<y>:STATe?
Arguments
Measurement Modes
Examples
WCA230A & WCA280A Programmer Manual
OFF or 0 hides the vertical line.
ON or 1 shows the vertical line.
All S/A modes
:CALCulate1:VLINe1:STATe ON
shows Vertical Line 1 in View 1.
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 and 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:
HRF gain calibration
HCenter offset calibration
HDC 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[: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
WCA230A & WCA280A Programmer Manual
:CALibration:AUTO (?)
:CALibration Commands
Determines whether to run the RF gain calibration automatically.
Syntax
Arguments
Measurement Modes
Examples
Related Commands
: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.
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
WCA230A & WCA280A Programmer Manual
:CALibration:DATA:DEFault
None
All
:CALibration:DATA:DEFault
restores the calibration data to the factory defaults.
2-65
:CALibration Commands
: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
Measurement Modes
Examples
:CALibration:OFFSet:BASebanddc
:CALibration:OFFSet:BASebanddc?
None
<NR1>
0 indicates a normal end. For details of the error codes, refer to page 3–17.
All
:CALibration:OFFSet:BASebanddc
runs the baseband DC offset calibration.
2-66
WCA230A & WCA280A Programmer Manual
:CALibration:OFFSet:CENTer (?)
Runs the center offset calibration. The query version of this command runs the
calibration and, if it ends normally, returns 0.
:CALibration Commands
Syntax
Arguments
Returns
Measurement Modes
Examples
:CALibration:OFFSet:CENTer
:CALibration:OFFSet:CENTer?
None
<NR1>
0 indicates a normal end. For details of the error codes, refer to page 3–17.
All
:CALibration:OFFSet:CENTer
runs the center offset calibration.
WCA230A & WCA280A Programmer Manual
2-67
:CALibration Commands
: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.
Syntax
Arguments
Returns
Measurement Modes
Examples
Related Commands
: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
2-68
WCA230A & WCA280A Programmer Manual
:CALibration:RF (?)
:CALibration Commands
Runs the RF gain calibration. The query version of this command runs the
calibration and, if it ends normally, returns 0.
Syntax
Arguments
Returns
Measurement Modes
Examples
Related Commands
: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-69
:CALibration Commands
2-70
WCA230A & WCA280A Programmer Manual
:CONFigure Commands
The :CONFigure commands set up the analyzer to the default settings for the
specified measurement.
Command Tree
HeaderParameter
:CONFigure
:ADEMod
:AM
:FM
:PM
:CCDF
:DDEMod
:OVIew
:SPECtrum
:ACPower
:CFRequency
:CHPower
:CNRatio
:EBWidth
:OBWidth
:SPURious
:TFRequency
:RTIMe
:SGRam
:TRANsient
:FVTime
:IQVTime
:PVTime
NOTE. Data acquisition stops on completion of a :CONFigure command. The
following each command description shows the front-panel key operation
equivalent to running the command except data acquisition control.
WCA230A & WCA280A Programmer Manual
2-71
:CONFigure Commands
: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
→ AM Demod side key
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CONFigure:ADEMod:AM
None
DEMADEM
:CONFigure:ADEMod:AM
sets up the analyzer to the default settings for AM signal analysis.
:INSTrument[:SELect]
: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
→ FM Demod side key
Measurement Modes
Related Commands
2-72
Syntax
Arguments
Examples
:CONFigure:ADEMod:FM
None
DEMADEM
:CONFigure:ADEMod:FM
sets up the analyzer to the default settings for FM signal analysis.
:INSTrument[:SELect]
WCA230A & WCA280A Programmer Manual
: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
→ PM Demod side key
:CONFigure Commands
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CONFigure:ADEMod:PM
None
DEMADEM
:CONFigure:ADEMod:PM
sets up the analyzer to the default settings for PM signal analysis.
:INSTrument[:SELect]
: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
:CONFigure:CCDF
Arguments
Measurement Modes
Examples
Related Commands
WCA230A & WCA280A Programmer Manual
None
TIMCCDF
:CONFigure:CCDF
sets up the analyzer to the default settings for CCDF measurement.
:INSTrument[:SELect]
2-73
:CONFigure Commands
: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
→ IQ/Frequency versus Time side key
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CONFigure:DDEMod
None
DEMDDEM
:CONFigure:DDEMod
sets up the analyzer to the default settings for digital modulation analysis.
:INSTrument[:SELect]
:CONFigure:OVIew (No Query Form)
Turns the measurement off in the Demod (modulation analysis) and the Time
(time analysis) modes to obtain data in the overview with the :FETCh:OVIew?
or the :READ:OVIew? command. Running this command is equivalent to
pressing the following front panel keys:
MEASURE key → Measurement Off side key
Measurement Modes
Related Commands
2-74
Syntax
Arguments
Examples
:CONFigure:OVIew
None
All Demod modes, all Time modes
:CONFigure:OVIew
turns the measurement off in the Demod and the Time modes.
:FETCh:OVIew?, :READ:OVIew?, :INSTrument[:SELect]
WCA230A & WCA280A Programmer Manual
:CONFigure:SPECtrum (No Query Form)
Sets up the analyzer to the default settings for spectrum measurement.
Running this command is equivalent to pressing the following front panel keys:
S/A key → { Spectrum Analyzer | S/A with Spectrogram | Real Time S/A
| Standard...→ { W-CDMA-DL | W-CDMA-UL | 3GPP-R5-DL }} side key →PRESET key →Measurement Off side key
:CONFigure Commands
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CONFigure:SPECtrum
None
All S/A modes
:CONFigure:SPECtrum
sets up the analyzer to the default settings for spectrum measurement.,
:INSTrument[:SELect]
:CONFigure:SPECtrum:ACPower (No Query Form)
Sets up the analyzer to the default settings for adjacent channel leakage power
ratio (ACPR) measurement. Running this command is equivalent to pressing the
following front panel keys:
S/A key → { Spectrum Analyzer | S/A with Spectrogram | Real Time S/A
| Standard...→ W-CDMA-DL | Standard...→ W-CDMA-UL } side key →PRESET key →ACPR or ACLR side key
Syntax
Arguments
Measurement Modes
Examples
Related Commands
WCA230A & WCA280A Programmer Manual
:CONFigure:SPECtrum:ACPower
None
SANORMAL, SASGRAM, SARTIME, SADL3G, SAUL3G
:CONFigure:SPECtrum:ACPower
sets up the analyzer to the default settings for ACPR measurement.
:INSTrument[:SELect]
2-75
:CONFigure Commands
:CONFigure:SPECtrum:CFRequency (No Query Form)
Sets up the analyzer to the default settings for carrier frequency measurement.
Running this command is equivalent to pressing the following front panel keys:
S/A key → { Spectrum Analyzer | S/A with Spectrogram | Real Time S/A
| Standard...→ { W-CDMA-DL | W-CDMA-UL | 3GPP-R5-DL }} side key →PRESET key →Carrier Frequency side key
Syntax
Arguments
Measurement Modes
Examples
Related Commands
:CONFigure:SPECtrum:CFRequency
None
All S/A modes
:CONFigure:SPECtrum:CFRequency
sets up the analyzer to the default settings for carrier frequency measurement.
:INSTrument[:SELect]
:CONFigure:SPECtrum:CHPower (No Query Form)
Sets up the analyzer to the default settings for channel power measurement.
Running this command is equivalent to pressing the following front panel keys:
S/A key → { Spectrum Analyzer | S/A with Spectrogram | Real Time S/A
| Standard...→ W-CDMA-DL | Standard...→ W-CDMA-UL } side key →PRESET key →Channel Power side key
Measurement Modes
Related Commands
2-76
Syntax
Arguments
Examples
:CONFigure:SPECtrum:CHPower
None
SANORMAL, SASGRAM, SARTIME, SADL3G, SAUL3G
:CONFigure:SPECtrum:CHPower
sets up the analyzer to the default settings for channel power measurement.
: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.