W-CDMA Programming Commands
Agilent Technologies E4406A VSA Series
Transmitter Tester
Manufacturing Part Number: E4406-90089
Printed in USA
April 2000
© Copyright 1999-2000 Agilent Technologies, Inc.
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
SCPI Command Subsystems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
CALCulate Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Code Domain Power Measurement Power Offset. . . . . . . . . . . . . . . . . .7
Code Domain Power Measurement Spread Code. . . . . . . . . . . . . . . . . .7
Code Domain Power Measurement Symbol Rate. . . . . . . . . . . . . . . . . .8
Code Domain Power Measurement Sweep Offset (Measurement Offset)
8
CodeDomainPowerMeasurementSweepTime(MeasurementInterval)
9
Query the Current Measurement Status . . . . . . . . . . . . . . . . . . . . . . . .9
Data Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Calculate/Compress Trace Data Query. . . . . . . . . . . . . . . . . . . . . . . . . .9
Calculate Peaks of Trace Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
CALCulate:MARKers Subsection . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
CONFigure Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
DISPlay Subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
Adjacent Channel Power Measurement View Selection . . . . . . . . . . .22
Spectrum Measurement Y-Axis Reference Level . . . . . . . . . . . . . . . . .22
Turn a Trace Display On/Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Waveform Measurement Y-Axis Reference Level . . . . . . . . . . . . . . . . .25
FETCh Subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
MEASure Group of Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Measure Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Configure Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
Fetch Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Read Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Adjacent Channel Power Ratio (ACP) Measurement. . . . . . . . . . . . . .30
Code Domain Power Measurement. . . . . . . . . . . . . . . . . . . . . . . . . . . .36
Channel Power Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
QPSK Error Vector Magnitude Measurement . . . . . . . . . . . . . . . . . . .41
3
Contents
Power Statistics CCDF Measurement . . . . . . . . . . . . . . . . . . . . . . . . .44
Rho (Waveform Quality) Measurement . . . . . . . . . . . . . . . . . . . . . . . .46
Spectrum (Frequency Domain) Measurement . . . . . . . . . . . . . . . . . . .48
Waveform (Time Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . .50
READ Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
SENSe Subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
Adjacent Channel Power Measurement . . . . . . . . . . . . . . . . . . . . . . . .53
Code Domain Power Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Channel Power Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
Correction for BTS RF Port External Attenuation. . . . . . . . . . . . . . . .78
Correction for Mobile Station RF Port External Attenuation . . . . . . .78
QPSK Error Vector Magnitude Measurement . . . . . . . . . . . . . . . . . . .80
Power Statistics CCDF Measurement . . . . . . . . . . . . . . . . . . . . . . . . .84
Radio Device Under Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Frequency Offset of MS to BTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Radio Format (Standard). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
Rho (Waveform Quality) Measurement . . . . . . . . . . . . . . . . . . . . . . . .88
Spectrum (Frequency-Domain) Measurement . . . . . . . . . . . . . . . . . .91
Waveform (Time-Domain) Measurement . . . . . . . . . . . . . . . . . . . . . .101
4
1 W-CDMA Programming
Commands
These commands are only available when the W-CDMA mode has been
selected using INSTrument:SELect. If W-CDMA mode is selected,
commands that are unique to another mode are not available.
5
W-CDMA Programming Commands
SCPI Command Subsystems
SCPI Command Subsystems
CALCulate on page 7
CONFigure on page 21
DISPlay on page 22
FETCh on page 26
MEASure on page 27
READ on page 52
SENSe on page 53
6 Chapter1
W-CDMA 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.
Code Domain Power Measurement Power Offset
:CALCulate:CDPower:PO1 <rel_power>
:CALCulate:CDPower:PO1?
Set the power offset value of the pilot bits.
:CALCulate:CDPower:PO2 <rel_power>
:CALCulate:CDPower:PO2?
Set the power offset value of the transmit control bits.
:CALCulate:CDPower:PO3 <rel_power>
:CALCulate:CDPower:PO3?
Set the power offset value of the transport format control indicator bits.
Factory Preset
and *RST: 0 dB
Range: −20 to 50 dB
Remarks: You must be in the W-CDMA mode to use this
command. Use INSTrument:SELect to set the mode.
Code Domain Power Measurement Spread Code
:CALCulate:CDPower:SPRead <integer>
:CALCulate:CDPower:SPRead?
Set a spread code.
Factory Preset
and *RST: 0
Range: 0 to 511, when CALCulate:CDPower:SRATe = 8
0 to 255, when CALCulate:CDPower:SRATe = 16
0 to 127, when CALCulate:CDPower:SRATe = 32
0 to 63, when CALCulate:CDPower:SRATe = 64
0 to 31, when CALCulate:CDPower:SRATe = 128
Chapter 1 7
W-CDMA Programming Commands
CALCulate Subsystem
0 to 15, when CALCulate:CDPower:SRATe = 256
0 to 7, when CALCulate:CDPower:SRATe = 512
0 to 3, when CALCulate:CDPower:SRATe = 1024
Remarks: You must be in the W-CDMA mode to use this
command. Use INSTrument:SELect to set the mode.
Code Domain Power Measurement Symbol Rate
:CALCulate:CDPower:SRATe <integer>
:CALCulate:CDPower:SRATe?
Set a symbol rate.
Factory Preset
and *RST: 16
Range: 8, 16, 32, 64, 128, 256, 512, 1024, when
[SENSe:]RADio:FORMat = ARIB
16, 32, 64, 128, 256, 512, 1024, when
[SENSe:]RADio:FORMat = Trial
Unit: ksps
Remarks: You must be in the W-CDMA mode to use this
command. Use INSTrument:SELect to set the mode.
Code Domain Power Measurement Sweep Offset (Measurement Offset)
:CALCulate:CDPower:SWEep:OFFSet <integer>
:CALCulate:CDPower:SWEep:OFFSet?
Set the timing offset of measurement interval in slots. (1 slot = 625 µs)
The sum of CALCulate:CDPower:SWEep:TIME and
CALCulate:CDPower:SWEep:OFFSet must be equal to or less than 32,
because data of 32 slots are acquired. If the sum becomes more than 32,
CALCulate:CDPower:SWEep:TIME is adjusted automatically.
Factory Preset
and *RST: 0
Range: 0 to 31
Unit: slots
Remarks: You must be in the W-CDMA mode to use this
command. Use INSTrument:SELect to set the mode.
8 Chapter1
W-CDMA Programming Commands
CALCulate Subsystem
Code Domain Power Measurement Sweep Time (Measurement Interval)
:CALCulate:CDPower:SWEep:TIME <integer>
:CALCulate:CDPower:SWEep:TIME?
Set the length of measurement interval in slots. (1 slot = 625 µs)
The sum of CALCulate:CDPower:SWEep:TIME and
CALCulate:CDPower:SWEep:OFFSet must be equal to or less than 32,
because data of 32 slots are acquired. If the sum becomes more than 32,
CALCulate:CDPower:SWEep:OFFSet is adjusted automatically.
Factory Preset
and *RST: 1
Range: 1 to 32
Unit: slots
Remarks: You must be in the W-CDMA 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 27 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
{,<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.
Chapter 1 9
W-CDMA Programming Commands
CALCulate Subsystem
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.
10 Chapter1
W-CDMA Programming Commands
CALCulate Subsystem
History: Added in revision A.03.00 and later
Measurement Available Traces Markers
Available?
ACP - adjacent channel power
(Basic, cdmaOne, cdma2000,
W-CDMA, iDEN, NADC, PDC modes)
CDPower - code domain power
(W-CDMA mode)
CHPower - channel power
(Basic, cdmaOne, cdma2000, W-CDMA
mode)
EVMQpsk - QPSK error vector
magnitude
(cdma2000, W-CDMA modes)
PSTatistic - power statistics CCDF
(cdma2000, W-CDMA modes)
no traces no markers
CDPower (n=2)
EVM (n=4)
MERRor (n=5)
PERRor (n=6)
SPOWer (n=8)
a
a
a
a
SPECtrum (n=2)
EVM (n=2)
MERRor (n=3)
PERRor (n=4)
a
a
a
MEASured (n=2)
GAUSsian (n=3)
REFerence (n=4)
a
a
a
a
a
yes
no markers
yes
yes
RHO - modulation quality
(cdmaOne, cdma2000, W-CDMA mode)
SPECtrum - (frequency domain)
(all modes)
WAVEform - (time domain)
(all modes)
EVM (n=2)
MAGerror (n=3)
PHASe (n=4)
RFENvelope (n=2)
for Service mode
IQ (n=3)
SPECtrum (n=4)
ASPectrum (n=7)
RFENvelope (n=2)
IQ (n=8)
a
a
a
a
a
a
yes
a
yes
a
a
yes
Chapter 1 11
W-CDMA Programming Commands
CALCulate Subsystem
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.
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: Returns a 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.
12 Chapter1
W-CDMA Programming Commands
CALCulate Subsystem
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
Chapter 1 13
W-CDMA 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.
W-CDMA Mode - <measurement> key words
• ACP - no markers
• CDPower - markers available
• CHPower - no markers
• EVMQpsk - markers available
• PSTatistic - 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.
14 Chapter1
W-CDMA 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
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.
Chapter 1 15
W-CDMA Programming Commands
CALCulate Subsystem
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
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
16 Chapter1
W-CDMA Programming Commands
CALCulate Subsystem
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]
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
Chapter 1 17
W-CDMA Programming Commands
CALCulate Subsystem
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
Measurement Available Traces Markers
Available?
ACP - adjacent channel power
no traces no markers
(Basic, cdmaOne, cdma2000,
W-CDMA, iDEN, NADC, PDC modes)
CDPower - code domain power
(W-CDMA mode)
CHPower - channel power
CDPower (n=2)
EVM (n=4)
MERRor (n=5)
PERRor (n=6)
SPOWer (n=8)
SPECtrum (n=2)
a
a
a
a
a
a
yes
no markers
(Basic, cdmaOne, cdma2000, W-CDMA
mode)
EVMQpsk - QPSK error vector
magnitude
(cdma2000, W-CDMA modes)
EVM (n=2)
MERRor (n=3)
PERRor (n=4)
a
a
a
yes
PSTatistic - power statistics CCDF
(cdma2000, W-CDMA modes)
MEASured (n=2)
GAUSian (n=3)
REFerence (n=4)
a
yes
a
a
18 Chapter1
W-CDMA Programming Commands
CALCulate Subsystem
Measurement Available Traces Markers
Available?
RHO - modulation quality
(cdmaOne, cdma2000, W-CDMA mode)
SPECtrum - (frequency domain)
(all modes)
WAVEform - (time domain)
(all modes)
EVM (n=2)
MAGerror (n=3)
PHASe (n=4)
RFENvelope (n=2)
for Service mode
IQ (n=3)
SPECtrum (n=4)
ASPectrum (n=7)
RFENvelope (n=2)
IQ (n=8)
a
a
a
a
a
a
yes
a
yes
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.
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
Chapter 1 19
W-CDMA 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)
20 Chapter1
W-CDMA 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 27.
Chapter 1 21
W-CDMA 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.
Adjacent Channel Power Measurement View Selection
:DISPlay:ACP:VIEW BGRaph|SPECtrum
:DISPlay:ACP:VIEW?
Select the adjacent channel power measurement display of bar graph or
spectrum.
Factory Preset
and *RST: BGRaph
Remarks: You must be in the cdma2000, W-CDMA, NADC or PDC
mode to use this command. Use INSTrument:SELect to
set the mode.
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.
22 Chapter1
W-CDMA Programming Commands
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
Turn a Trace Display On/Off
:DISPlay:TRACe[n][:STATe] OFF|ON|0|1
:DISPlay:TRACe[n][:STATe]?
DISPlay Subsystem
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 27 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
Chapter 1 23
W-CDMA Programming Commands
DISPlay Subsystem
Measurement Available Traces Markers
Available?
ACP - adjacent channel power
(Basic, cdmaOne, cdma2000,
W-CDMA, iDEN, NADC, PDC modes)
CDPower - code domain power
(W-CDMA mode)
CHPower - channel power
(Basic, cdmaOne, cdma2000, W-CDMA
mode)
EVMQpsk - QPSK error vector
magnitude
(cdma2000, W-CDMA modes)
PSTatistic - power statistics CCDF
(cdma2000, W-CDMA modes)
no traces no markers
CDPower (n=2)
EVM (n=4)
MERRor (n=5)
PERRor (n=6)
SPOWer (n=8)
a
a
a
a
SPECtrum (n=2)
EVM (n=2)
MERRor (n=3)
PERRor (n=4)
a
a
a
MEASured (n=2)
GAUSian (n=3)
REFerence (n=4)
a
a
a
a
a
yes
no markers
yes
yes
RHO - modulation quality
(cdmaOne, cdma2000, W-CDMA mode)
SPECtrum - (frequency domain)
(all modes)
WAVEform - (time domain)
(all modes)
EVM (n=2)
MAGerror (n=3)
PHASe (n=4)
RFENvelope (n=2)
for Service mode
IQ (n=3)
SPECtrum (n=4)
ASPectrum (n=7)
RFENvelope (n=2)
IQ (n=8)
a
a
a
a
a
a
yes
a
yes
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.
24 Chapter1
W-CDMA 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,
Chapter 1 25
W-CDMA 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 27.
26 Chapter1
W-CDMA 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.
Chapter 1 27
W-CDMA Programming Commands
MEASure Group of Commands
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
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
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.
CONFigure
ABORt
returns
to this
point
Sets default
state then
waits
SENSe & CALCulate
commands
change the
settings from
the defaults
MEASure
INITiate
INITiate:RESTart
READ
Initialize
taking of
data
FETch
Acquired data
is calculated
and returned
ca81a
28 Chapter1
W-CDMA Programming Commands
MEASure Group of Commands
Fetch Commands
: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
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>?.
Chapter 1 29
W-CDMA 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.
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.
30 Chapter1
Loading...