NADC, PDC Programming Commands
Agilent Technologies E4406A VSA Series
Transmitter Tester
Manufacturing Part Number: E4406-90060
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
1. NADC Programming Commands
SCPI Command Subsystems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
CALCulate Subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Adjacent Channel Power Measurement Limit Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Query the Current Measurement Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Calculate Data Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Error Vector Magnitude Measurement First 10 Symbols EVM Limit . . . . . . . . . . . . . . . . . 7
Error Vector Magnitude Measurement I/Q Origin Offset Error Limit . . . . . . . . . . . . . . . . . 8
Error Vector Magnitude Measurement Peak EVM Limit . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Error Vector Magnitude Measurement RMS EVM Limit . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Error Vector Magnitude Measurement Limit Testing Control . . . . . . . . . . . . . . . . . . . . . . . 9
CALCulate:MARKers Subsection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
CONFigure Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Configure Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
DISPlay Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Adjacent Channel Power Measurement View Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Error Vector Magnitude Measurement View Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Select Display Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Turn a Trace Display On/Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
FETCh Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
MEASure Group of Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Measure Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Configure Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Fetch Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Read Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Adjacent Channel Power (ACP) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Error Vector Magnitude Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Spectrum (Frequency Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Waveform (Time Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
READ Subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
SENSe Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Adjacent Channel Power Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Burst Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Slot number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Slot Auto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Correction for Base Station RF Port External Attenuation . . . . . . . . . . . . . . . . . . . . . . . . . 37
Correction for Mobile Station RF Port External Attenuation . . . . . . . . . . . . . . . . . . . . . . . 37
Error Vector Magnitude Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
RF Port Input Attenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
RF Port Power Range Auto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
RF Port Power Range Maximum Total Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Radio Test Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Radio Traffic Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Spectrum (Frequency-Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Burst Sync Delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Burst Search Threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Waveform (Time-Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
2. PDC Programming Commands
3
Contents
SCPI Command Subsystems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
CALCulate Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
Adjacent Channel Power Measurement Limit Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
Query the Current Measurement Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
Calculate Data Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
Error Vector Magnitude Measurement I/Q Origin Offset Error Limit . . . . . . . . . . . . . . . . .63
Error Vector Magnitude Measurement Peak EVM Limit . . . . . . . . . . . . . . . . . . . . . . . . . . .64
Error Vector Magnitude Measurement RMS EVM Limit . . . . . . . . . . . . . . . . . . . . . . . . . . .64
Error Vector Magnitude Measurement Limit Testing Control . . . . . . . . . . . . . . . . . . . . . . .64
CALCulate:MARKers Subsection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
Occupied Bandwidth Measurement Frequency Band Limit . . . . . . . . . . . . . . . . . . . . . . . . .71
Occupied Bandwidth Measurement Limit Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
CONFigure Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
Configure Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
DISPlay Subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Adjacent Channel Power Measurement View Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Error Vector Magnitude Measurement View Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Select Display Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Turn a Trace Display On/Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
FETCh Subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
MEASure Group of Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
Measure Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
Configure Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
Fetch Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
Read Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
Adjacent Channel Power (ACP) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
Error Vector Magnitude Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
Occupied Bandwidth Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
Spectrum (Frequency Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
Waveform (Time Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
READ Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
SENSe Subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
Adjacent Channel Power Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
Burst Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
Slot number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
Slot Auto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
Correction for Mobile Station RF Port External Attenuation . . . . . . . . . . . . . . . . . . . . . . . .95
Error Vector Magnitude Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
Occupied Bandwidth Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
RF Port Input Attenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
RF Port Power Range Auto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
RF Port Power Range Maximum Total Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
Radio Test Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102
Radio Traffic Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102
Spectrum (Frequency-Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
Burst Sync Delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
Burst Search Threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
Waveform (Time-Domain) Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114
4
1 NADC Programming Commands
These commands are only available when the NADC mode has been
selected using INSTrument:SELect. If NADC mode is selected,
commands that are unique to another mode are not available.
5
NADC Programming Commands
SCPI Command Subsystems
SCPI Command Subsystems
CALCulate on page 7
CONFigure on page 16
DISPlay on page 17
FETCh on page 19
MEASure on page 20
READ on page 31
SENSe on page 32
6 Chapter1
NADC 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 Measurement Limit Test
:CALCulate:ACP:LIMit[:TEST] OFF|ON|0|1
:CALCulate:ACP:LIMit[:TEST]?
Turn limit test on or off.
Factory Preset
and *RST: On
Remarks: You must be in the NADC or PDC 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
Calculate 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 20 for information on the data
that can be returned for each measurement.
Error Vector Magnitude Measurement First 10 Symbols EVM Limit
:CALCulate:EVM:LIMit:F10 <percent>
:CALCulate:EVM:LIMit:F10?
Set the first 10 symbols EVM limit in percent. This function is only for
mobile testing.
Chapter 1 7
NADC Programming Commands
CALCulate Subsystem
Factory Preset
and *RST: 25.0%
Range: 0 to 50%
Remarks: You must be in the NADC mode to use this command.
Use INSTrument:SELect to set the mode.
Error Vector Magnitude Measurement I/Q Origin Offset Error Limit
:CALCulate:EVM:LIMit:IQOOffset <dB>
:CALCulate:EVM:LIMit:IQOOffset?
Set the I/Q origin offset error limit in dB.
Factory Preset
and *RST: −20 dB
Range: −100 dB to 0 dB
Remarks: You must be in the NADC or PDC mode to use this
command. Use INSTrument:SELect to set the mode.
Error Vector Magnitude Measurement Peak EVM Limit
:CALCulate:EVM:LIMit:PEAK <percent>
:CALCulate:EVM:LIMit:PEAK?
Set the peak EVM limit in percent.
Factory Preset
and *RST: 40.0%
Range: 0 to 50%
Remarks: You must be in the NADC or PDC mode to use this
command. Use INSTrument:SELect to set the mode.
Error Vector Magnitude Measurement RMS EVM Limit
:CALCulate:EVM:LIMit:RMS <percent>
:CALCulate:EVM:LIMit:RMS?
Set the RMS EVM limit in percent.
Factory Preset
and *RST: 12.5%
Range: 0 to 50%
8 Chapter1
NADC Programming Commands
CALCulate Subsystem
Remarks: You must be in the NADC or PDC mode to use this
command. Use INSTrument:SELect to set the mode.
Error Vector Magnitude Measurement Limit Testing Control
:CALCulate:EVM:LIMit[:TEST] OFF|ON|0|1
:CALCulate:EVM:LIMit[:TEST]?
Turn limit test on or off.
Factory Preset
and *RST: On
Remarks: You must be in the NADC or PDC mode to use this
command. Use INSTrument:SELect to set the mode.
Chapter 1 9
NADC Programming Commands
CALCulate Subsystem
CALCulate:MARKers Subsection
Each measurement has its own instrument state for marker
parameters. Therefore, the marker settings in each measurement are
saved if you exit the measurement and are then recalled when you
change back to that measurement.
In using the marker commands it is necessary to specify the
measurement in the SCPI command. It is highly recommended 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.
NADC Mode - valid <measurement> key words
• ACP - adjacent channel power measurement
• EVM - error vector magnitude measurement
• SPECtrum - spectrum (frequency domain) measurement
• WAVeform - waveform (time domain) measurement
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
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, AREFerence, PVTime, 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 marker function for the specified marker.
Some measurements may only have one or two markers available. Also,
10 Chapter1
NADC Programming Commands
CALCulate Subsystem
they may not have both noise and band-power markers. For example,
the WAVeform measurement only uses two markers and only has
band-power markers.
Use :CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
BPOWeris 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, AREFerence, PVTime, 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.
Some measurements may only have one or two markers available. Also,
they may not have both noise and band-power markers. For example,
the WAVeform measurement only uses two markers and only has
band-power markers.
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, AREFerence, PVTime, 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. Use
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
Chapter 1 11
NADC Programming Commands
CALCulate Subsystem
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 and AREFerence)
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. 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, AREFerence, PVTime)
Front Panel
Access:
Search, More, Min Search
Marker Mode
:CALCulate:<measurement>:MARKer[1]|2|3|4:MODE
POSition|DELTa
:CALCulate:<measurement>:MARKer[1]|2|3|4:MODE?
Selects the marker mode to be position or delta
Some measurements may only have one or two markers available. Also,
they may not have both position and delta markers. Several
measurements only have position markers.
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 and AREFerence)
Front Panel
Access:
12 Chapter1
Marker, Marker [Delta]
NADC 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.
Some measurements may only have one or two markers available. Also,
they may not have both noise and band-power markers. For example,
the WAVeform measurement only uses two markers and only has
band-power markers.
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>|<trace_name>
:CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe?
Assigns the specified marker to the designated trace. Not all
measurement data can have traces assigned to it.
Example: CALC:SPEC:MARK2:TRACE RFENvelope
Range: The names of valid traces are dependent upon the
selected measurement. See the “MEASure Group of
Commands” on page 20 for more detailed information
about the available traces. Note that the trace name
assignment is independent of the window number.
Measurement Available Traces
SPECtrum (frequency domain)
RFENvelope (n=2)
IQ (n=3)
SPECtrum (n=4)
ASPectrum (n=7)
a
a
a
a
WAVEform - (time
domain)
Chapter 1 13
RFENvelope (n=2)
IQ (n=8)
a
a
NADC Programming Commands
CALCulate Subsystem
Measurement Available Traces
ACP - adjacent
channel power
EVM - error vector
magnitude
no markers
EVM (n=2)
MERRor (n=3)
PERRor (n=4)
a
a
a
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.
Remarks: The keyword for the current measurement must be
specified in the command. (Some examples include:
SPECtrum, AREFerence, PVTime)
Front Panel
Access:
Marker, Marker Trace
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 value is in the X-axis units (which is often frequency or
time). 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.
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, AREFerence, PVTime, WAVeform)
Front Panel
Access:
Marker, <active marker>, RPG
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
14 Chapter1
NADC Programming Commands
CALCulate Subsystem
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. 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.
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, AREFerence, PVTime)
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).
Use :CALCulate:<measurement>:MARKer[1]|2|3|4:TRACe to assign a
marker to a particular trace.
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, AREFerence, PVTime)
Chapter 1 15
NADC 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 20.
Configure Query
:CONFigure?
The CONFigure? query returns the current measurement name.
16 Chapter1
NADC 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 view either bar graph mode or spectrum mode.
Factory Preset
and *RST: BGRaph
Remarks: You must be in the NADC or PDC mode to use this
command. Use INSTrument:SELect to set the mode.
Error Vector Magnitude Measurement View Selection
:DISPlay:EVM:VIEW POLar|CONStln|QUAD
:DISPlay:EVM:VIEW?
Select the view of EVM measurement
Factory Preset
and *RST: POLar
Remarks: You must be in the NADC or PDC mode to use this
command. Use INSTrument:SELect to set the mode.
Select Display Format
:DISPlay:FORMat:TILE
Selects the viewing format that displays multiple windows of the
current measurement data simultaneously.
Front Panel
Access: Next Window
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.
Chapter 1 17
NADC Programming Commands
DISPlay Subsystem
n is a sub-opcode that is valid for the current measurement. See the
“MEASure Group of Commands” on page 20 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. The trace name
assignment is independent of the window number.
Measurement Available Traces and Sub-opcodes
SPECtrum (frequency domain)
WAVEform - (time
domain)
ACP - adjacent
RFENvelope (n=2)
IQ (n=3)
a
SPECtrum (n=4)
ASPectrum (n=7)
RFENvelope (n=2)
IQ (n=8)
a
no markers
a
a
a
a
channel power
EVM - error vector
magnitude
EVM (n=2)
MERRor (n=3)
PERRor (n=4)
a
a
a
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.
Remarks: To use this command, the appropriate mode should be
selected with INSTrument:SELect.
Front Panel
Access:
Display, Display Traces
18 Chapter1
NADC 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 20.
Chapter 1 19
NADC 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 SCPIcommunication, 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
20 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
NADC 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 21
NADC 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 SCPIcommunication, 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>?.
22 Chapter1
NADC Programming Commands
MEASure Group of Commands
Adjacent Channel Power (ACP) Measurement
This measures the total rms power in the specified channel and in 5
offset channels. You must be in the 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
information for more measurement related commands.
:CONFigure:ACP
:FETCh:ACP[n]?
:READ:ACP[n]?
:MEASure:ACP[n]?
Measurement results available:
n Results Returned
0 Returns unprocessed I/Q trace data, as a data array of comma-separated
trace points, in volts.
1(default) Returns 22 comma-separated scalar results, in the following order:
Center freq – absolute power (dBm)
Center freq – absolute power (W)
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)
2 Returns 10 comma-separated scalar values of the pass/fail (1=passed, or
0=failed) results determined by testing the absolute power of the offset
frequencies:
Negative offset frequency(1) absolute power
Positive offset frequency(1) absolute power
....
Negative offset frequency(5) absolute power
Positive offset frequency(5) absolute power
3 Returns 10 comma-separated scalar values of the pass/fail (1=passed, or
0=failed) results determined by testing the relative power of the offset
frequencies:
Negative offset frequency(1) relative power
Positive offset frequency(1) relative power
....
Negative offset frequency(5) relative power
Positive offset frequency(5) relative power
Chapter 1 23
NADC Programming Commands
MEASure Group of Commands
n Results Returned
4 Returns the frequency-domain spectrum trace (data array) for the entire
frequency range being measured.
In order to return spectrum data, the NADC display must be in the
spectrum display mode.
Remarks: You must be in the NADC or PDC mode to use this
command. Use INSTrument:SELect to set the mode.
24 Chapter1
NADC Programming Commands
MEASure Group of Commands
Error Vector Magnitude Measurement
This measures the vector error of the magnitude of each symbol. You
must be in the 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:EVM
information for more measurement related commands.
:CONFigure:EVM
:FETCh:EVM[n]?
:READ:EVM[n]?
:MEASure:EVM[n]?
Measurement results available:
n Results Returned
0 Returns unprocessed I/Q trace data, as a data array of comma-separated
trace points, in volts.
1 (default) NADC returns the following 8 comma-separated scalar results, in order.
1. RMS EVM – a floating point number (in percent) of EVM over the entire
measurement area.
2. Peak EVM error – a floating point number (in percent) of peak EVM in
the measurement area.
3. Symbol position of the peak EVM error – an integer number of the
symbol position where the peak EVM error is detected.
4. First 10 symbols EVM error – a floating point number (in percent) of
EVM over the first 10 symbols.
5. Magnitude error – a floating point number (in percent) of average
magnitude error over the entire measurement area.
6. Phase error – a floating point number (in degree) of average phase error
over the entire measurement area.
7. Frequency error – a floating point number (in Hz) of the frequency error
in the measured signal.
8. I/Q origin offset – a floating point number (in dB) of the I and Q error
(magnitude squared) offset from the origin.
2 Returns series of floating point numbers (in percent) that represent each
sample in the EVM trace. The first number is the symbol 0 decision point
and there are 5 points per symbol. Therefore, the decision points are at 0, 5,
10, 15....
Chapter 1 25
NADC Programming Commands
MEASure Group of Commands
n Results Returned
3 Returns series of floating point numbers (in percent) that represent each
sample in the magnitude error trace. The first number is the symbol 0
decision point and there are 5 points per symbol. Therefore, the decision
points are at 0, 5, 10, 15....
4 Returns series of floating point numbers (in degree) that represent each
sample in the phase error trace. The first number is the symbol 0 decision
point and there are 5 points per symbol. Therefore, the decision points are at
0, 5, 10, 15....
5 Returns series of floating point numbers that alternately represent I and Q
pairs of the corrected measured trace. The magnitude of each I and Q pair
are normalized to 1.0. The first number is the in-phase (I) sample of symbol
0 decision point and the second is the quadrature-phase (Q) sample of
symbol 0 decision point. As in the EVM, there are 5 points per symbol, so
that:
1st number = I of the symbol 0 decision point
2nd number = Q of the symbol 0 decision point
....
11th number = I of the symbol 1 decision point
12th number = Q of the symbol 1 decision point
....
10xNth + 1 number = I of the symbol N decision point
10xNth + 2 number = Q of the symbol N decision point
6 NADC returns the following 4 comma-separated scalar values of 1 or 0, in
the order given. The pass/fail results (1=passed, or 0=failed) are determined
by testing the EVM, peak EVM, first 10 symbols EVM and IQ origin offsets.
Test result of EVM
Test result of peak EVM
Test result of first 10 symbols EVM
Test result of IQ origin offset
Remarks: You must be in the PDC mode to use this command.
Use INSTrument:SELect to set the mode.
26 Chapter1
NADC Programming Commands
MEASure Group of Commands
Spectrum (Frequency Domain) Measurement
This measures the amplitude of your input signal with respect to the
frequency. It provides spectrum analysis capability using FFT (fast
Fourier transform) measurement techniques. You must select the
appropriate mode using INSTrument:SELect, to use these commands.
The general functionality of CONFigure, FETCh, MEASure, and READ
are described at the beginning of this section. See the
SENSe:SPECtrum information for more measurement related
commands.
:CONFigure:SPECtrum
:FETCh:SPECtrum[n]?
:READ:SPECtrum[n]?
:MEASure:SPECtrum[n]?
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.
not specified or
n=1
Returns the following comma-separated scalar results:
1. FFT peak is the FFT peak amplitude.
2. FFT frequency is the FFT frequency of the peak amplitude.
3. FFT points is the Number of points in the FFT spectrum.
4. First FFT frequency is the frequency of the first FFT point of the
spectrum.
5. FFT spacing is the frequency spacing between the FFT points of the
spectrum.
6. Time domain points is the number of points in the time domain trace
used for the FFT.
7. First time point is the time of the first time domain point, where time
zero is the trigger event.
8. Time spacing is the time spacing between the time domain points.
9. Time domain returns a 1, if time domain is complex (I/Q), or 0 if it is
real. (raw ADC samples)
10. Scan time is the total scan time of the time domain trace used for the
FFT.
11.Current average count is the current number of data measurements
that have already been combined, in the averaging calculation.
Chapter 1 27
NADC Programming Commands
MEASure Group of Commands
n Results Returned
2, Service mode
only
3 Returns the I and Q trace data. It is represented by I and Q pairs (in volts)
4 Returns spectrum trace data. That is, the trace of log-magnitude versus
5, Service mode
only
6 Not used.
7 Returns the averaged spectrum trace data. That is, the trace of the
8 Not used.
9 Returns a trace containing the shape of the FFT window.
10, Service mode
only
Returns the trace data of the log-magnitude versus time. (That is, the RF
envelope.)
versus time.
frequency. (The trace is computed using a FFT.)
Returns the averaged trace data of log-magnitude versus time. (Thatis, the
RF envelope.)
averaged log-magnitude versus frequency.
Returns trace data of the phase of the FFT versus frequency.
Front Panel
Access:
Measure, Spectrum (Freq Domain)
After the measurement is selected, press Restore Meas
Defaults to restore factory defaults.
28 Chapter1
NADC Programming Commands
MEASure Group of Commands
Waveform (Time Domain) Measurement
This measures the power in your input signal with respect to time and
is equivalent to zero-span operation in a traditional spectrum analyzer.
You must select the appropriate mode using INSTrument:SELect, to
use these commands.
The general functionality of CONFigure, FETCh, MEASure, and READ
are described at the beginning of this section. See the
SENSe:WAVeform information for more measurement related
commands.
:CONFigure:WAVeform
:FETCh:WAVeform[n]?
:READ:WAVeform[n]?
:MEASure:WAVeform[n]?
Measurement Results Available
n Results Returned
0, or 8 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.
not specified or
n=1
Returns the following comma-separated scalar results:
1. Sample time is a floating point number representing the time between
samples when using the trace queries (n=0,2,etc).
2. Mean power is the mean power (in dBm). This is either the power
across the entire trace, or the power between markers if the markers are
enabled. If averaging is on, the power is for the latest acquisition.
3. Mean power averaged is the power (in dBm) for N averages, if
averaging is on. This is either the power across the entire trace, or the
power between markers if the markers are enabled. If averaging is on,
the power is for the latest acquisition. If averaging is off, the value of the
mean power averaged is the same as the value of the mean power.
4. Number of samples is the number of data points in the captured
signal. This number is useful when performing a query on the signal
(i.e. when n=0,2,etc.).
5. Peak-to-mean ratio has units of dB. The peak is defined to be the
maximum level of the signal (non-averaged). The mean is the mean
power (non-averaged). If averaging is on, the peak-to-mean ratio is
invalid.
6. Maximum value is the maximum of the most recently acquired data
(in dBm).
7. Minimum value is the minimum of the most recently acquired data (in
dBm).
Chapter 1 29
NADC Programming Commands
MEASure Group of Commands
n Results Returned
2 Returns comma-separated trace points of the entire captured trace data.
These data points are floating point numbers representing the power of the
signal (in dBm). There are N data points, where N is the number of
samples. The period between the samples is defined by the sample time.
Front Panel
Access:
Measure, Waveform (Time Domain)
After the measurement is selected, press Restore Meas
Defaults to restore factory defaults.
30 Chapter1
Loading...