This subsystem contains commands related to the transfer of trace data to and from the instrument.
:TRACe:PREamble? <trace type>
Title
Trace Header Transfer
Description
Returns trace header information for the specified trace. The <trace type> must be one of the following: SINGle|MULTi|PVTFrame|PVTSlot|DEMod
Data can be transferred to and from the 5 available display trace types. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory. The response begins with an ASCII header. The header specifies the number of following bytes. It looks like #AX, where A is the number of digits in X and X is the number of bytes that follow the header. Note that the instrument must be set in the selected view. Use the CONFigure commands to set the unit to the selected view.
Parameters are returned in comma‑delimited ASCII format. Each parameter is returned as “NAME=VALUE[ UNITS].” Note that the parameters that are returned depend on the firmware version and that this document may not cover all parameter values that are returned by the command. Refer to Table: Returned Parameter Values in Trace Preamble (Sheet 1 of 2).
Parameter
<trace type>
Related Command
:TRACe:DATA?
Returned Parameter Values in Trace Preamble (Sheet 1 of 2)
Parameter Name
Description
SN
Instrument serial #
UNIT_NAME
Instrument name
TYPE
The data type (Setup or Data)
DESCR
Trace name
DATE
Trace date/time
BASE_VER
Base FW version
APP_NAME
Application name
APP_VER
Application FW version
APP_MODE
Application Mode
REFERENCE_LEVEL
Reference Level
CENTER_FREQ
Center freq
SIGNAL_STANDARD
Current signal standard (the value is the index of the signal standard list, where a value of 1 is the first index in the list)
CHANNEL
Current channel
POWER_OFFSET
Applied power offset
REFERENCE_FREQUENCY
Selected external reference frequency
UNITS
Amplitude units
CURRENT_VIEW
Current view
CURRENT_MEASURMENTS
Current measurements
DYNAMIC_ATTENUATION
Dynamic range on/off
SPAN
Frequency span
MANUAL_SYSTEM_SELECT
GSM/EDGE select
CURRENT_SPECTRUM_VIEW
Current spectrum view (single or multiple channel spectrum)
I_Q_VIEW
IQ view
RUN_HOLD
Run/Hold on/off
MC_SPECTRUM_START_FREQ
Multi-channel spectrum start frequency
MC_SPECTRUM_STOP_FREQ
Multi-channel spectrum stop frequency
MC_CHANNEL_CURSOR
Multi-channel spectrum channel cursor (used for markers)
MC_FREQ_CURSOR
Multi-channel spectrum frequency cursor (used for markers)
TEST_MODEL
Current pass fail model being tested
:TRACe[:DATA]? <trace type>
Title
Trace Data Transfer
Description
This command transfers trace data from the instrument to the controller. The <trace type> must be one of the following: SINGle|MULTi|PVTFrame|PVTSlot|DEMod.
The format of the block data in the query form is specified by :FORMat:DATA. The block data in the command form is always sent in ASCII format. The response begins with an ASCII header that specifies the number of data bytes. It looks like #AX, where A is the number of digits in X and X is the number of bytes that follow the header. Each data-point is separated by a comma delimiter. Trace setup information can be acquired using :TRACe[:DATA]:PREamble?.
Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory. Except for DEMod, there is only one value per data-point. For DEMod, each data-point is represented by 2 values, 4 bytes each: IData (no units), and QData (no units). For SINGle, MULTi, PVTFrame, and PVTSlot, the unit is in dBm. Note that the instrument must be set in the selected view. Use the CONFigure commands to set the unit to the selected view.