cdmaOne Programming Commands
Agilent Technologies E4406A VSA Series
Transmitter Tester
Manufacturing Part Number: E4406-90102
Printed in USA
April 2000
© Copyright 1999-2000 Agilent Technologies Company
The information contained in this document is subject to change
without notice.
Agilent Technologiesmakesnowarrantyofanykindwithregard to this
material, including but not limited to, the implied warranties of
merchantability and fitness for a particular purpose. Agilent
Technologies shall not be liable for errors contained herein or for
incidental or consequential damages in connection with the furnishing,
performance, or use of this material.
2
Contents
1. cdmaOne Programming Commands
SCPI Command Subsystems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
CALCulate Subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Adjacent Channel Power Limit Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Query the Current Measurement Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Data Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Calculate/Compress Trace Data Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Calculate Peaks of Trace Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
CALCulate:MARKers Subsection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
CONFigure Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
DISPlay Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Spectrum Measurement Y-Axis Reference Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Turn a Trace Display On/Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Waveform Measurement Y-Axis Reference Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
FETCh Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
MEASure Group of Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Measure Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Configure Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Fetch Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Read Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Adjacent Channel Power Ratio (ACP) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Code Domain Power Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Channel Power Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Close Spurs Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Rho (Waveform Quality) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Spectrum (Frequency Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Waveform (Time Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
READ Subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
SENSe Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Adjacent Channel Power Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Code Domain Power Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Channel Power Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Correction for Base Station RF Port External Attenuation . . . . . . . . . . . . . . . . . . . . . . . . . 71
Close Spurs Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Select the Input Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Center Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Center Frequency Step Size Automatic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Center Frequency Step Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
RF Port Input Attenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
RF Port Power Range Auto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
RF Port Power Range Maximum Total Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Radio Carrier Multiple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
Radio Standard Band . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
Rho (Waveform Quality) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Reference Oscillator External Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Reference Oscillator Rear Panel Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Reference Oscillator Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Spectrum (Frequency-Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Sync Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
3
Contents
Waveform (Time-Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
4
1 cdmaOne Programming
Commands
These commands are only available when the cdmaOne mode has been
selected using INSTrument:SELect. If cdmaOne mode is selected,
commands that are unique to another mode are not available.
5
cdmaOne Programming Commands
SCPI Command Subsystems
SCPI Command Subsystems
CALCulate on page 7
CONFigure on page 19
DISPlay on page 20
FETCh on page 24
MEASure on page 25
READ on page 47
SENSe on page 48
6 Chapter1
cdmaOne Programming Commands
CALCulate Subsystem
CALCulate Subsystem
This subsystem is used to perform post-acquisition data processing. In
effect, the collection of new data triggers the CALCulate subsystem. In
this instrument, the primary functions in this subsystem are markers
and limits.
Adjacent Channel Power Limit Test
:CALCulate:ACP:LIMit:STATe OFF|ON|0|1
:CALCulate:ACP:LIMit:STATe?
Turn limit test on or off.
Factory Preset
and *RST: On
Remarks: You must be in Basic, cdmaOne, iDEN mode to use this
command. Use INSTrument:SELect to set the mode.
Query the Current Measurement Status
:CALCulate:CLIMits:FAIL?
Checks if the current measurement is outside its limits. It returns a 0
(zero) if it is passing or a 1 (one) if it is failing.
Front Panel
Access: None
Data Query
:CALCulate:DATA[n]?
Returns the designated measurement data for the currently selected
measurement and sub-opcode.
n = any valid sub-opcode for the current measurement. See the
“MEASure Group of Commands” on page 25 for information on the data
that can be returned for each measurement.
Calculate/Compress Trace Data Query
:CALCulate:DATA[n]:COMPress?
MAXimum|MEAN|MINimum|RMS|SAMPle|SDEViation|CFIT
Chapter 1 7
cdmaOne Programming Commands
CALCulate Subsystem
{,<soffset>}{,<length>}{,<roffset>}
Returns the designated trace data for the currently selected
measurement. The command can be used with sub-opcodes (n) for
measurement results that are trace data. See the following table.
This command is used to compress/decimate a long trace to extract the
desired data and only return to the computer the necessary data. A
typical example would be to acquire N bursts of GSM data and return
the mean power of each burst.
The command can also be used to identify the best curve fit for the data.
Curve Fit - applies curve fitting routines to the data. Where
<soffset> and <length> are required, and <roffset> is an optional
parameter for the desired order of the curve equation. The query will
return the following values: the x-offset (in points) and the curve
coefficients ((order + 1) values).
<Start offset> - is an optional integer. It specifies the amount of data,
at the beginning of the trace, that will be ignored before the
decimation process starts. It is an integer index (that starts counting
at zero) for all the elements in the trace. The default value is zero.
<Length> - is an optional integer that defines how many trace
elements will be compressed into one value. This parameter has a
default value equal to the current trace length.
<Repeat offset> - is an optional real number.It defines the beginning
of the next field of trace elements to be compressed. This is relative
to the beginning of the previous field. This parameter has a default
value equal to the <length> variable. Select a number such that
repeated additions will round to the correct starting index.
Example: To query the mean power of a set of GSM bursts:
1. Set the waveform measurement sweep time to
acquire the required number of bursts.
2. Set the triggers such that acquisition happens at a
known position relative to a burst.
3. Then query the mean burst levels using,
CALC:DATA2:COMP? MEAN,62,1315,1442.3 (These
parameter values correspond to GSM signals.)
Remarks: The optional parameters must be entered in the
specified order. If you want to specify <length>, you
must also specify <soffset> or it’s default. (e.g.
CALC:DATA2:COMP? MEAN,62,1315
This command uses the data setting specified by the
FORMat:DATA command and can return binary or
ascii data.
8 Chapter1
cdmaOne Programming Commands
History: Added in revision A.03.00 and later
CALCulate Subsystem
Measurement Available Traces
ACP - adjacent channel power
(Basic, cdmaOne, cdma2000,
W-CDMA, iDEN, NADC, PDC modes)
CDPower - code domain power
(cdmaOne mode)
CHPower - channel power
(Basic, cdmaOne, cdma2000, W-CDMA
mode)
CSPur - spurs close
(cdmaOne mode)
RHO - modulation quality
(cdmaOne, cdma2000, W-CDMA mode)
Markers
Available?
no traces no markers
POWer (n=2)
TIMing (n=3)
PHASe (n=4)
a
a
a
SPECtrum (n=2)
SPECtrum (n=2)
ULIMit (n=3)
EVM (n=2)
MERRor (n=3)
PERRor (n=4)
a
a
a
a
a
a
yes
no markers
yes
yes
SPECtrum - (frequency domain)
(all modes)
WAVEform - (time domain)
(all modes)
RFENvelope (n=2)
for Service mode
IQ (n=3)
a
SPECtrum (n=4)
ASPectrum (n=7)
RFENvelope (n=2)
IQ (n=8)
a
a
yes
a
a
a
yes
a. The n number indicates the sub-opcode that corresponds to this
trace. Detailed descriptions of the trace data can be found in the
MEASure subsystem documentation by looking up the
sub-opcode for the appropriate measurement.
Chapter 1 9
cdmaOne Programming Commands
CALCulate Subsystem
Calculate Peaks of Trace Data
:CALCulate:DATA[n]:PEAKs?
<threshold>,<excursion>[,AMPLitude|FREQuency|TIME]
Returns a list of peaks for the designated trace data n for the currently
selected measurement. The peaks must meet the requirements of the
peak threshold and excursion values.
The command can be used with sub-opcodes (n) for any measurement
results that are trace data. See the table above. Subopcode n=0, raw
trace data cannot be searched for peaks. Both real and complex traces
can be searched, but complex traces are converted to magnitude in
dBm.
Threshold - is the level below which trace data peaks are ignored
Excursion - To be defined as a peak, the signal must rise above the
threshold by a minimum amplitude change. Excursion is measured
from the lowest point above the threshold (of the rising edge of the
peak), to the highest signal point that begins the falling edge.
Amplitude - lists the peaks in order of descending amplitude, so the
highest peak is listed first. This is the default peak order listing if
the optional parameter is not specified.
Frequency - lists the peaks in order of occurrence, left to right across
the x-axis
Time - lists the peaks in order of occurrence, left to right across the
x-axis
Example: Select the spectrum measurement.
Use CALC:DATA4:PEAK? -40,10,FREQ to identify the
peaks above -40 dBm, with excursions of at least 10 dB,
in order of increasing frequency.
Query Results: Returnsa list of floating-point numbers. The first value
in the list is the number of peak points that follow. A
peak point consists of two values: a peak amplitude
followed by the its corresponding frequency (or time).
If no peaks are found the peak list will consist of only
the number of peaks, (0).
The peak list is limited to 100 peaks. Peaks in excess of
100 are ignored.
Remarks: This command uses the data setting specified by the
FORMat:DATA command and can return real 32-bit,
real 64-bit, or ASCII data. The default data format is
ASCII.
History: Added in revision A.03.00 and later
10 Chapter1
cdmaOne Programming Commands
CALCulate Subsystem
Chapter 1 11
cdmaOne Programming Commands
CALCulate Subsystem
CALCulate:MARKers Subsection
When using the marker commands you must specify the measurement
in the SCPI command. We recommend that you use the marker
commands only on the current measurement. Many marker commands
will return invalid results, when used on a measurement that is not
current. (This is true for commands that do more than simply setting or
querying an instrument parameter.) No error is reported for these
invalid results.
You must make sure that the measurement is completed before trying
to query the marker value. Using the MEASure or READ command,
before the marker command, forces the measurement to complete
before allowing the next command to be executed.
Each measurement has its own instrument state for marker
parameters. Therefore, if you exit the measurement, the marker
settings in each measurement are saved and are then recalled when
you change back to that measurement.
cdmaOne Mode - <measurement> key words
• ACPr - no markers
• CHPower - no markers
• CDPower - markers available
• CSPur - markers available
• RHO - markers available
• SPECtrum - markers available
• WAVeform - markers available
Example:
Suppose you are using the Spectrum measurement. Toposition marker
2 at the maximum peak value, of the trace that marker 2 is currently
on, the command is:
:CALCulate:SPECtrum:MARKer2:MAXimum
You must make sure that the measurement is completed before trying
to query the marker value. Using the MEASure or READ command,
before the marker command, forces the measurement to complete
before allowing the next command to be executed.
12 Chapter1
cdmaOne Programming Commands
CALCulate Subsystem
Markers All Off on All Traces
:CALCulate:<measurement>:MARKer:AOFF
Turns off all markers on all the traces.
Example: CALC:SPEC:MARK:AOFF
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, WAVeform)
Front Panel
Access:
Marker, More, Marker All Off
Marker Function
:CALCulate:<measurement>:MARKer[1]|2|3|4:FUNCtion
BPOWer|NOISe|OFF
:CALCulate:<measurement>:MARKer[1]|2|3|4:FUNCtion?
Selects the type of marker for the specified marker. A particular
measurement may not have all the types of markers that are commonly
available.
The marker must have already been assigned to a trace. Use
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
Band Power − is the integrated power between the two markers for
traces in the frequency domain and is the mean power between the
two markers for traces in the time domain.
Noise − is the noise power spectral density in a 1 Hz bandwidth. It is
averaged over 32 horizontal trace points.
Off − turns off the marker functions
Example: CALC:SPEC:MARK3:FUNC Noise
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, WAVeform)
Front Panel
Access:
Marker, Marker Function
Chapter 1 13
cdmaOne Programming Commands
CALCulate Subsystem
Marker Function Result
:CALCulate:<measurement>:MARKer[1]|2|3|4:FUNCtion:RESult?
Quires the result of the currently active marker function. The
measurement must be completed before querying the marker.A
particular measurement may not have all the types of markers
available.
The marker must have already been assigned to a trace. Use
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
Example: CALC:SPEC:MARK:FUNC:RES?
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, WAVeform)
Front Panel
Access:
Marker, Marker Function
Marker Peak (Maximum) Search
:CALCulate:<measurement>:MARKer[1]|2|3|4:MAXimum
Places the selected marker on the highest point on the trace that is
assigned to that particular marker number.
The marker must have already been assigned to a trace. Use
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
Example: CALC:SPEC:MARK1:MAX
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, WAVeform)
Front Panel
Access: Search
14 Chapter1
cdmaOne Programming Commands
CALCulate Subsystem
Marker Peak (Minimum) Search
:CALCulate:<measurement>:MARKer[1]|2|3|4:MINimum
Places the selected marker on the lowest point on the trace that is
assigned to that particular marker number.
The marker must have already been assigned to a trace. Use
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
Example: CALC:SPEC:MARK2:MIN
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, WAVeform)
Front Panel
Access: None
Marker Mode
:CALCulate:<measurement>:MARKer[1]|2|3|4:MODE
POSition|DELTa
:CALCulate:<measurement>:MARKer[1]|2|3|4:MODE?
Selects the type of marker to be a normal position-type marker or a
delta marker.A specific measurement may not have both types of
markers. For example, several measurements only have position
markers.
The marker must have already been assigned to a trace. Use
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
Example: CALC:SPEC:MARK:MODE DELTA
Remarks: For the delta mode only markers 1 and 2 are valid.
The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, WAVeform)
Front Panel
Access:
Marker, Marker [Delta]
Chapter 1 15
cdmaOne Programming Commands
CALCulate Subsystem
Marker On/Off
:CALCulate:<measurement>:MARKer[1]|2|3|4[:STATe] OFF|ON|0|1
:CALCulate:<measurement>:MARKer[1]|2|3|4[:STATe]?
Turns the selected marker on or off.
The marker must have already been assigned to a trace. Use
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
Example: CALC:SPEC:MARK2: on
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, AREFerence, WAVeform)
The WAVeform measurement only has two markers
available.
Front Panel
Access: M
arker, Select then Marker Normal or Marker On Off
Marker to Trace
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe <trace_name>
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe?
Assigns the specified marker to the designated trace. Not all types of
measurement data can have markers assigned to them.
Example: With the WAVeform measurement selected, a valid
command is CALC:SPEC:MARK2:TRACE rfenvelope.
Range: The names of valid traces are dependent upon the
selected measurement. See the following table for the
available trace names. The trace name assignment is
independent of the marker number.
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, WAVeform)
Front Panel
Access:
Marker, Marker Trace
16 Chapter1
cdmaOne Programming Commands
CALCulate Subsystem
Measurement Available Traces
ACP - adjacent channel power
(Basic, cdmaOne, cdma2000,
W-CDMA, iDEN, NADC, PDC modes)
CDPower - code domain power
(cdmaOne mode)
CHPower - channel power
(Basic, cdmaOne, cdma2000, W-CDMA
mode)
CSPur - spurs close
(cdmaOne mode)
RHO - modulation quality
(cdmaOne, cdma2000, W-CDMA mode)
Markers
Available?
no traces no markers
POWer (n=2)
TIMing (n=3)
PHASe (n=4)
a
a
a
SPECtrum (n=2)
SPECtrum (n=2)
ULIMit (n=3)
EVM (n=2)
MERRor (n=3)
PERRor (n=4)
a
a
a
a
a
a
yes
no markers
yes
yes
SPECtrum - (frequency domain)
(all modes)
WAVEform - (time domain)
(all modes)
RFENvelope (n=2)
for Service mode
IQ (n=3)
a
SPECtrum (n=4)
ASPectrum (n=7)
RFENvelope (n=2)
IQ (n=8)
a
a
yes
a
a
a
yes
a. The n number indicates the sub-opcode that corresponds to this
trace. Detailed descriptions of the trace data can be found in the
MEASure subsystem documentation by looking up the
sub-opcode for the appropriate measurement.
Chapter 1 17
cdmaOne Programming Commands
CALCulate Subsystem
Marker X Value
:CALCulate:<measurement>:MARKer[1]|2|3|4:X <param>
:CALCulate:<measurement>:MARKer[1]|2|3|4:X?
Position the designated marker on its assigned trace at the specified X
value. The parameter value is in X-axis units (which is often frequency
or time).
The marker must have already been assigned to a trace. Use
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
The query returns the current X value of the designated marker. The
measurement must be completed before querying the marker.
Example: CALC:SPEC:MARK2:X 1.2e6 Hz
Default Unit: Matches the units of the trace on which the marker is
positioned
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, WAVeform)
Front Panel
Access: Marker, <active marker>, RPG
18 Chapter1
cdmaOne Programming Commands
CALCulate Subsystem
Marker X Position
:CALCulate:<measurement>:MARKer[1]|2|3|4:X:POSition
<integer>
:CALCulate:<measurement>:MARKer[1]|2|3|4:X:POSition?
Position the designated marker on its assigned trace at the specified X
position. A trace is composed of a variable number of measurement
points. This number changes depending on the current measurement
conditions. The current number of points must be identified before
using this command to place the marker at a specific location.
The marker must have already been assigned to a trace. Use
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
The query returns the current X position for the designated marker.
The measurement must be completed before querying the marker.
Example: CALC:SPEC:MARK:X:POS 500
Range: 0 to a maximum of (3 to 920,000)
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, WAVeform)
Front Panel
Access:
Marker, <active marker>, RPG
Marker Readout Y Value
:CALCulate:<measurement>:MARKer[1]|2|3|4:Y?
Readout the current Y value for the designated marker on its assigned
trace. The value is in the Y-axis units for the trace (which is often dBm).
The marker must have already been assigned to a trace. Use
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
The measurement must be completed before querying the marker.
Example: CALC:SPEC:MARK1:Y -20 dB
Default Unit: Matches the units of the trace on which the marker is
positioned
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, WAVeform)
Chapter 1 19
cdmaOne Programming Commands
CONFigure Subsystem
CONFigure Subsystem
:CONFigure:<measurement>
The CONFigure commands are used with several other commands and
are documented in the section on the “MEASure Group of Commands”
on page 25.
20 Chapter1
cdmaOne Programming Commands
DISPlay Subsystem
DISPlay Subsystem
The DISPlay controls the selection and presentation of textual,
graphical, and TRACe information. Within a DISPlay, information may
be separated into individual WINDows.
Spectrum Measurement Y-Axis Reference Level
:DISPlay:SPECtrum[n]:WINDow[m]:TRACe:Y[:SCALe]:RLEVel
<power>
:DISPlay:SPECtrum[n]:WINDow[m]:TRACe:Y[:SCALe]:RLEVel?
Sets the amplitude reference level for the y-axis.
n − selects the view, the default is Spectrum.
— n=1, Spectrum
— n=2, I/Q Waveform
— n=3, numeric data (service mode)
— n=4, RF Envelope (service mode)
m − selects the window within the view. The default is 1.
Factory Preset
and *RST: 0 dBm, for Spectrum
Range: −250 to 250 dBm, for Spectrum
Default Unit: dBm, for Spectrum
Remarks: May affect input attenuator setting.
To use this command, the appropriate mode should be
selected with INSTrument:SELect.
Front Panel
Access: When in Spectrum measurement:
Level
Amplitude Y Scale, Ref
Chapter 1 21
cdmaOne Programming Commands
DISPlay Subsystem
Turn a Trace Display On/Off
:DISPlay:TRACe[n][:STATe] OFF|ON|0|1
:DISPlay:TRACe[n][:STATe]?
Controls whether the specified trace is visible or not.
n is a sub-opcode that is valid for the current measurement. See the
“MEASure Group of Commands” on page 25 for more information about
sub-opcodes.
Factory Preset
and *RST: On
Range: The valid traces and their sub-opcodes are dependent
upon the selected measurement. See the following
table.
The trace name assignment is independent of the
window number.
Remarks: To use this command, the appropriate mode should be
selected with INSTrument:SELect.
Front Panel
Access: Display, Display Traces
22 Chapter1
cdmaOne Programming Commands
DISPlay Subsystem
Measurement Available Traces
ACP - adjacent channel power
(Basic, cdmaOne, cdma2000,
W-CDMA, iDEN, NADC, PDC modes)
CDPower - code domain power
(cdmaOne mode)
CHPower - channel power
(Basic, cdmaOne, cdma2000, W-CDMA
mode)
CSPur - spurs close
(cdmaOne mode)
RHO - modulation quality
(cdmaOne, cdma2000, W-CDMA mode)
Markers
Available?
no traces no markers
POWer (n=2)
TIMing (n=3)
PHASe (n=4)
a
a
a
SPECtrum (n=2)
SPECtrum (n=2)
ULIMit (n=3)
EVM (n=2)
MERRor (n=3)
PERRor (n=4)
a
a
a
a
a
a
yes
no markers
yes
yes
SPECtrum - (frequency domain)
(all modes)
WAVEform - (time domain)
(all modes)
RFENvelope (n=2)
for Service mode
IQ (n=3)
a
SPECtrum (n=4)
ASPectrum (n=7)
RFENvelope (n=2)
IQ (n=8)
a
a
yes
a
a
a
yes
a. The n number indicates the sub-opcode that corresponds to this
trace. Detailed descriptions of the trace data can be found in the
MEASure subsystem documentation by looking up the
sub-opcode for the appropriate measurement.
Chapter 1 23
cdmaOne Programming Commands
DISPlay Subsystem
Waveform Measurement Y-Axis Reference Level
:DISPlay:WAVEform[n]:WINDow[m]:TRACe:Y[:SCALe]:RLEVel
<power>
:DISPlay:WAVEform[n]:WINDow[m]:TRACe:Y[:SCALe]:RLEVel?
Sets the amplitude reference level for the y-axis.
n, selects the view, the default is RF envelope.
n=1, RF envelope
n=2, I/Q waveform
m, selects the window within the view. The default is 1.
Factory Preset
and *RST: 0 dBm, for RF envelope
Range: −250 to 250 dBm, for RF envelope
Default Unit: dBm, for RF envelope
Remarks: May affect input attenuator setting.
To use this command, the appropriate mode should be
selected with INSTrument:SELect.
Front Panel
Access: When in Waveform measurement:
Ref Level
Amplitude Y Scale,
24 Chapter1
cdmaOne Programming Commands
FETCh Subsystem
FETCh Subsystem
:FETCh:<measurement>[n]?
The FETCh? commands are used with several other commands and are
documented in the section on the “MEASure Group of Commands” on
page 25.
Chapter 1 25
cdmaOne Programming Commands
MEASure Group of Commands
MEASure Group of Commands
This group includes commands used to make measurements and return
results. The different commands can be used to provide fine control of
the overall measurement process. Most measurements should be done
in single measurement mode, rather than doing the measurement
continuously.
Each measurement sets the instrument state that is appropriate for
that measurement. Other commands are available for each
allow changing settings, view, limits, etc. Refer to:
SENSe:<measurement>, SENSe:CHANnel, SENSe:CORRection,
SENSe:FREQuency, SENSe:POWer, SENSe:RADio, SENSe:SNYC
CALCulate:<measurement>, CALCulate:CLIMits/DATA
DISPlay:<measurement>
TRIGger
Mode to
Measure Commands
:MEASure:<measurement>[n]?
This is a fast single-command way to make a measurement using the
factory default instrument settings. These are the settings and units
that conform to the Standard.
• Stops the current measurement and sets up the instrument for the
specified measurement using the factory defaults
• Initiates the data acquisition for the measurement
• Blocks other SCPI communication,waiting until the measurement is
complete before returning results.
• After the data is valid it returns the scalar results, or the trace data,
for the specified measurement.
If the optional [n] value is not included, or is set to 1, the scalar
measurement results will be returned. If the [n] value is set to a
value other than 1, the selected trace data results will be returned.
See each command for details of what types of scalar results or trace
data results are available. The binary data formats should be used
for handling large blocks of data since they are smaller and faster
then the ASCII format.
If you need to change some of the measurement parameters from the
factory default settings you can set up the measurement with the
CONFigure command. Use the commands in the
SENSe:<measurement> and CALCulate:<measurement> subsystems
to change the settings. Then you can use the READ? command, or the
INITiate and FETCh? commands, to initiate the measurement and
26 Chapter1
query the results. See Figure 1-1.
If you need to repeatedly make a given measurement with settings
other than the factory defaults, you can use the commands in the
SENSe:<measurement> and CALCulate:<measurement> subsystems
to set up the measurement. Then use the READ? command or INITiate
and FETCh? commands, to initiate the measurement and query results.
Measurement settings persist if you initiate a different measurement
and then return to a previous one. Use READ:<measurement>? if you
want to use those persistent settings. If you want to go back to the
default settings, use MEASure:<measurement>?.
Figure 1-1 Measurement Group of Commands
MEASure
READ
cdmaOne Programming Commands
MEASure Group of Commands
Start from
Any Inst State
Configure Commands
:CONFigure:<measurement>
This command sets up the instrument for the specified measurement
using the factory default instrument settings and stops the current
measurement. It does not initiate the taking of measurement data.
The CONFigure? query returns the current measurement name.
Fetch Commands
CONFigure
ABORt
returns
to this
point
Sets default
state then
waits
SENSe & CALCulate
commands
change the
settings from
the defaults
INITiate
INITiate:RESTart
Initialize
taking of
data
FETch
Acquired data
is calculated
and returned
ca81a
:FETCh:<measurement>[n]?
This command puts valid data into the output buffer, but does not
initiate data acquisition. Use the INITiate[:IMMediate] command to
acquire data before you use the FETCh command. You can only fetch
results from the measurement that is currently selected.
If the optional [n] value is not included, or is set to 1, the scalar
measurement results will be returned. If the [n] value is set to a value
Chapter 1 27
cdmaOne Programming Commands
MEASure Group of Commands
other than 1, the selected trace data results will be returned. See each
command for details of what types of scalar results or trace data results
are available. The binary data formats should be used for handling
large blocks of data since they are smaller and faster then the ASCII
format.
Read Commands
:READ:<measurement>[n]?
• Does not preset the measurement to the factory defaults. (The
MEASure? command does preset.) It uses the settings from the last
measurement.
• Initiates the measurement and puts valid data into the output
buffer. If a measurement other than the current one is specified, the
instrument will switch to that measurement before it initiates the
measurement and returns results.
• Blocks other SCPI communication,waiting until the measurement is
complete before returning the results
If the optional [n] value is not included, or is set to 1, the scalar
measurement results will be returned. If the [n] value is set to a
value other than 1, the selected trace data results will be returned.
See each command for details of what types of scalar results or trace
data results are available. The binary data formats should be used
when handling large blocks of data since they are smaller and faster
then the ASCII format.
Measurement settings persist if you initiate a different measurement
and then return to a previous one. Use READ:<measurement>? if you
want to use those persistent settings. If you want to go back to the
default settings, use MEASure:<measurement>?.
28 Chapter1
cdmaOne Programming Commands
MEASure Group of Commands
Adjacent Channel Power Ratio (ACP) Measurement
This measures the total rms power in the specified channel and in 5
offset channels. You must be in Basic, cdmaOne, cdma2000, W-CDMA,
iDEN, NADC or PDC mode to use these commands. Use
INSTrument:SELect to set the mode.
The general functionality of CONFigure, FETCh, MEASure, and READ
are described at the beginning of this section. See the SENSe:ACP
commands for more measurement related commands.
:CONFigure:ACP
:FETCh:ACP[n]?
:READ:ACP[n]?
:MEASure:ACP[n]?
For Basic mode, a channel frequency and power level can be defined in
the command statement to override the default standard setting. A
comma must precede the power value as a place holder for the
frequency, when no frequency is sent.
Measurement
Type
History: Added to Basic mode, version A.03.00 or later
Front Panel
Access:
Measure, ACPR
After the measurement is selected, press Restore Meas
Defaults to restore factory defaults.
Measurement Results Available
n Results Returned
0 Returns unprocessed I/Q trace data, as a series of
comma-separated trace points, in volts. The I values are listed
first in each pair, using the 0 through even-indexed values. The
Q values are the odd-indexed values.
Chapter 1 29
cdmaOne Programming Commands
MEASure Group of Commands
Measurement
Type
Total power
reference
Power spectral
density
reference
n Results Returned
not
specified
or n=1
cdmaOne,
cdma2000,
or
W-CDMA
mode
not
specified
or n=1
cdmaOne,
cdma2000,
or
W-CDMA
mode
Returns 24 comma-separated scalar results, in the following
order:
Center freq - relative power (dB)
Center freq - absolute power (dBm)
Center freq - relative power (dB)
Center freq - absolute power (dBm)
Negative offset freq(1) - relative power (dB),
Negative offset freq(1) - absolute power (dBm)
Positive offset freq(1) - relative power (dB)
Positive offset freq(1) - absolute power (dBm)
...
Positive offset freq(5) - relative power (dB)
Positive offset freq(5) - absolute power (dBm)
Returns 24 comma-separated scalar results, in the following
order:
Center freq - relative power (dB)
Center freq - absolute power (dBm/Hz)
Center freq - relative power (dB)
Center freq - absolute power (dBm/Hz)
Negative offset freq(1) - relative power (dB)
Negative offset freq(1) - absolute power (dBm/Hz)
Positive offset freq(1) - relative power (dB)
Positive offset freq(1) - absolute power (dBm/Hz)
...
Positive offset freq(5) - relative power (dB)
Positive offset freq(5) - absolute power (dBm/Hz)
Total power
reference
2
cdmaOne,
cdma2000,
or
W-CDMA
mode
30 Chapter1
Returns 11 comma-separated scalar values (in dBm)
corresponding to the total power histogram display. The values
are returned in ascending frequency order:
Negative offset frequency(5)
Negative offset frequency(4)
...
Center frequency
Positive Offset frequency(1)
...
Positive Offset frequency(5)
Loading...