Trace Subsystem

This subsystem contains commands related to the transfer of trace data to and from the instrument.

Trace Data Transfer

:TRACe[:DATA] 1|2|3,(<header><block>)

:TRACe[:DATA]? [1]|2|3

This command transfers data from the controlling program to the instrument. The query form transfers trace data from the instrument to the controller. Data is transferred to the instrument enclosed in parentheses as (<header><block>) and from the instrument as <header><block>.

The ASCII header 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 in the <block>.

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.

Data can be transferred to and from the 3 available display traces. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory.

The command form does not support setting all trace points to a single value. To do this, send the same value to each point.

Trace setup information can be acquired using :TRACe[:DATA]:PREamble?.

To acquire the data from trace A in the instrument send :TRACe[:DATA]? 1. A 551 point trace will be returned as #42204<block data>. <block> data could be in either INTeger,32 or REAL,32 format. In both cases, there will be 4 bytes per data point. So, 4 bytes per point * 551 data points gives 2204 bytes in <block> data. This example assumes that :FORMat:DATA INTeger,32 or :FORMat:DATA REAL,32 has been sent to the instrument before the query command is sent.

See Also:

:FORMat:DATA :TRACe[:DATA]:PREamble?

 

Trace Header Transfer

:TRACe:PREamble? [1]|2|3

Returns trace header information for the specified trace.

Data can be transferred to and from the 3 available display traces. 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.

Parameters are returned in comma-delimited ASCII format. Each parameter will be returned as “NAME=VALUE[ UNITS],”

Valid parameter names are:

Parameter Name	Description
SN	Instrument serial #
UNIT_NAME	Instrument name
DESCR	Trace name
DATE	Trace date/time
BASE_VER	Base FW version
APP_NAME	Application name
APP_VER	Application FW version

 

Parameter Name	Description
UNITS	Amplitude units
CENTER_FREQ	Center freq
SPAN	Frequency span
FREQ_STEP	Frequency step size
RBW	Resolution bw
RBW_TYPE	RBW coupling auto/manual
VBW	Video bw
VBW_TYPE	VBW coupling auto/manual
RBW_VBW_RATIO	RBW/VBW ratio
SPAN_RBW_RATIO	Span/RBW ratio
INPUT_ATTEN	Input attenuation
ATTEN_TYPE	Attenuation coupling auto/manual
REFERENCE_LEVEL	Reference level
SCALE	Y-axis scale
PREAMP_SET	Preamp state
REF_LEVEL_OFFSET	Reference level offset
DETECTION	Detection type
TRACE_AVERAGE	Number of traces to average
SWEEP_TYPE	Single/continuous
CURRENT_SIGNAL	Current signal index
CURRENT_CHANNEL	Current signal channel
TRACE_MODE	Normal/Avg/Max
TRACE_STATUS	TRACE_A_VIEW_NOT_BLANK 0x0000000000000001 TRACE_A_WRITE_NOT_HOLD 0x0000000000000002 TRACE_A_DATA_VALID 0x0000000000000004 TRACE_B_VIEW_NOT_BLANK 0x0000000000010000 TRACE_B_WRITE_NOT_HOLD 0x0000000000020000 TRACE_B_DATA_VALID 0x0000000000040000 TRACE_C_VIEW_NOT_BLANK 0x0000000100000000 TRACE_C_WRITE_NOT_HOLD 0x0000000200000000 TRACE_C_DATA_VALID 0x0000000400000000 TRACE_C_IS_B_MINUS_A_ON 0x0000001000000000 TRACE_C_IS_A_MINUS_B_ON 0x0000002000000000
TRACE_COUNT	Number of traces averaged
UI_DATA_POINTS	Number of display points
IMPEDANCE	Input impedance
REFERENCE_ FREQUENCY	Reference freq
SET_SWEEP_TIME	Minimum sweep time setting
TRIGGER_TYPE	Trigger type
VIDEO_TRIGGER_ LEVEL	Video trigger level
TRIGGER_POSITION	Trigger position as a percent of the display
PEAK_THRESHOLD	Marker peak search threshold
MARKER_TABLE	Marker table status

 

Parameter Name	Description
ACTIVE_ MEASUREMENT	Current measurement
ANTENNA	Antenna index
OCC_BW_METHOD	Occupied bandwidth method
OCC_BW_PERCENT	Occupied bandwidth % of power setting
OCC_BW_DBC	Occupied bandwidth dBc setting
OCC_BW_MEASURED_ DB	Occupied bandwidth measured dBc value
OCC_BW_MEASURED_ PERCENT	Occupied bandwidth measured % value
OCC_BW_VALUE	Measured occupied bandwidth
OCC_BW_LINE_ MARKER_INFO	Mask off 16 bits at a time to get the display point location of the 3 OBW display indicators
CH_PWR_WIDTH	Channel power integration bandwidth
CH_PWR_VALUE	Measured channel power
CH_PWR_DENSITY	Measured channel power density
CH_PWR_LINE_ MARKER_INFO	Mask off 16 bits at a time to get the display point location of the 2 channel power display indicators
ACPR_MAIN_CH_BW	ACPR main channel bw
ACPR_ADJC_CH_BW	ACPR adjacent channel bw
ACPR_CHANNEL_ SPACING	ACPR channel spacing
ACPR_MAIN_CH_PWR	ACPR measured main channel power
ACPR_UPPER_CH_PWR	ACPR measured upper channel power
ACPR_LOWER_CH_ PWR	ACPR measured lower channel power
ACPR_LOWER_CH_ LINE_MARKER_INFO	Mask off 16 bits at a time to get the display point location of the 2 ACPR lower channel display indicators
ACPR_MAIN_CH_LINE_ MARKER_INFO	Mask off 16 bits at a time to get the display point location of the 2 ACPR main channel display indicators
ACPR_UPPER_CH_ LINE_MARKER_INFO	Mask off 16 bits at a time to get the display point location of the 2 ACPR upper channel display indicators
AM_FM_DEMOD_VOL	AM/FM demod volume
AM_FM_DEMOD_ FREQUENCY	AM/FM demod freq
AM_FM_DEMOD_TYPE	AM/FM demod type
AM_FM_DEMOD_TIME	AM/FM demod time
AM_FM_LINE_ MARKER	Display point location of the demodulation frequency
BEAT_FREQUENCY_ OSC_FREQUENCY	BFO oscillator freq
CI_C_TYPE	C/I measurement carrier type
CI_C_VALUE	C/I measurement measured carrier power
CI_I_BB_VALUE	C/I measurement measured broadband interference power
CI_I_NB_VALUE	C/I measurement measured narrowband interference power
CI_I_WB_VALUE	C/I measurement measured wideband interference power
CI_BB_VALUE	C/I measurement with broadband interference
CI_NB_VALUE	C/I measurement with narrowband interference
CI_WB_VALUE	C/I measurement with wideband interference

 

Parameter Name	Description
MKR_REF_FREQNx	Reference marker x frequency (where x is the marker number 0-5)
MKR_REF_POINTx	Reference marker x display point
MKR_REF_MAGNTx	Reference marker x magnitude
MKR_REF_PRCNTx	Reference marker x display percentage
MKR_REF_FLAGSx	Reference marker x flags: MKR_FLAG_ON_OFF 0x00000001 MKR_FLAG_NOISE 0x00000002 MKR_FLAG_PHASE_NOISE 0x00000004 MKR_FLAG_AMP_TRACK 0x00000008 MKR_FLAG_DELTA_MKR 0x00000020 MKR_FLAG_DATA_INVALID 0x00000040 MKR_FLAG_DATA_STALE 0x00000080 MKR_FLAG_SELECTED 0x00000100 MKR_FLAG_COUNTER 0x00000200 MKR_FLAG_DELT_DISPL_PER_HZ 0x00000800 MKR_FLAG_TRACE_A 0x00001000 MKR_FLAG_TRACE_B 0x00002000 MKR_FLAG_TRACE_C 0x00004000 MKR_FLAG_TRACE_MASK 0x00007000
MKR_DLT_FREQNx	Delta marker x frequency (where x is the marker number 0-5)
MKR_DLT_POINTx	Delta marker x display point
MKR_DLT_MAGNTx	Delta marker x magnitude
MKR_DLT_PRCNTx	Delta marker x display percentage
MKR_DLT_FLAGSx	Delta marker x flags:

 

Parameter Name	Description
LIM_LFLAGS_UP-1	Upper limit flags: LIMIT_FLAG_UPPER 0x00000001 LIMIT_FLAG_ON 0x00000004 LIMIT_FLAG_ALARM_ON 0x00000002 LIMIT_FLAG_SEGMENTED 0x00000020 LIMIT_FLAG_ALARM_EVENT 0x00000040 LIMIT_FLAG_LEFT_OF_START_FREQ 0x00000080 LIMIT_FLAG_RIGHT_OF_STOP_FREQ 0x00000100 LIMIT_FLAG_MASK 0x000007FF
LIM_NUMPTS_UP-1	Number of upper limit points
LIM_FREQNC_UPx	Upper limit point x freq (where x is the limit point number starting with 0)
LIM_MAGNTD_UPx	Upper limit point x amplitude
LIM_LFLAGS_LO-1	Lower limit flags: LIMIT_FLAG_UPPER 0x00000001 LIMIT_FLAG_ON 0x00000004 LIMIT_FLAG_ALARM_ON 0x00000002 LIMIT_FLAG_SEGMENTED 0x00000020 LIMIT_FLAG_ALARM_EVENT 0x00000040 LIMIT_FLAG_LEFT_OF_START_FREQ 0x00000080 LIMIT_FLAG_RIGHT_OF_STOP_FREQ 0x00000100 LIMIT_FLAG_MASK 0x000007FF
LIM_NUMPTS_LO-1	Number of lower limit points
LIM_FREQNC_LOx	Lower limit point x freq (where x is the limit point number starting with 0)
LIM_MAGNTD_LOx	Lower limit point x amplitude

 

See Also:

:TRACe:DATA

 

 

Tracking Generator Option Only: Parameter Name	Description
TG_SET_ON_OFF	Set tracking generator power; On/Off
TG_SET_OUTPUT_POWER	Set tracking generator output power; 0dBm to -40dBm
TG_REFERENCE_LEVEL	Tracking generator S21 normalized reference level; On/Off
TG_SCALE	Tracking generator specific scale for S21 normalized display only; +100 to -120 dBm
TG_UNITS	Tracking generator log / linear scale units. Currently defaulted to Log scale only; 0x00
TG_TRACE_STATUS	Tracking generator S21 normalized trace status; S21 OFF: 0x00 Normalizing Sweep: 0x11 Valid Sweep: 0x12
TG_REF_LEVEL_OFFSET	Tracking Generator S21 Normalized reference level offset; +100 to -100dBm
See Also:	:TRACe:DATA

 

Copyright 2011 Anritsu Company
	Anritsu Company
	1800-ANRITSU
	10450-00034, Rev. A
	mmdtechpubs@anritsu.com