FETCh Commands

This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement.

To get new measurement data, use the READ command.

Fetch Adjacent Channel Leakage Ratio

:FETCh:ACLR?

Returns the most recent adjacent channel leakage ratio measurement results.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as 12 comma-separated values: -20 MHz channel power, -15 MHz channel power, -10 MHz channel power, -5 MHz channel power, Main channel power 1, Main channel power 2, Main channel power 3, Main channel power 4, +5 MHz channel power, +10 MHz channel power, +15 MHz channel power, +20 MHz channel power.

Default Units:

dBm

 

Fetch Channel Power

:FETCh:CHPower?

Returns the most recent channel power measurement results.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Default Units:

dBm

 

Fetch Active Channel Count

:FETCh:DEMod:ACTChannels?

Returns the active channel count from the most recent measurement results.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as a single value representing the total number of active channels.

Default Units:

No units

 

Fetch Demodulated Channel Power

:FETCh:DEMod:CDPower?

Returns the most recent absolute power measurement results for the requested logical channel.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as 4 comma-delimited values: CPICH power, PCCPCH power, PICH power, SCCPCH power.

Default Units:

dBm

 

Fetch Carrier Feed Through

:FETCh:DEMod:CFTHrough?

Returns the most recent carrier feed through measurement results.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as a single value representing the carrier feed through.

Default Units:

dB

 

Fetch Error Vector Magnitude (EVM)

:FETCh:DEMod:EVM?

Returns the most recent EVM measurement result.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as a single value representing the RMS error vector magnitude.

Default Units:

Percent

 

Fetch Frequency Error

:FETCh:DEMod:FERRor?

Returns the most recent frequency error measurement result.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as a single value representing the frequency error.

Default Units:

Hertz

 

Fetch Code Domain Noise Floor

:FETCh:DEMod:NFLoor?

Returns the most recent code domain noise floor measurement result.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as a single value representing the noise floor power level.

Default Units:

dB

 

Fetch Total Channel Count

:FETCh:DEMod:NUMChannels?

Returns the total channel count from the most recent measurement results.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as a single value representing the total number of channels.

Default Units:

No units

 

Fetch Synch Channel Power

:FETCh:DEMod:SPOWer?

Returns the most recent absolute power measurement results for the requested synch channel.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as 3 comma-delimited values: SCH power, PSCH power, SSCH power.

Default Units:

dBm

 

Fetch Transmitter Frequency

:FETCh:DEMod:TXFRequency?

Returns the most recent transmitter frequency measurement results.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as a single value representing the carrier frequency.

Default Units:

Hertz

 

Fetch Spectral Emission Mask Results

:FETCh:EMISsion?

Returns the most recent spectral emission mask pass/fail and template measurement results.

Any violation of the spectral emission mask template will cause a FAIL result.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as 2 comma-delimited values: PASS/FAIL status (PASS = 0, FAIL = 1), template number. See :FETCh:EMISsion:TEMPlate command for valid template numbers.

Default Units:	No units
See Also	:FETCh:EMISsion:FAIL? :FETCh:EMISsion:TEMPlate?

 

Fetch Spectral Emission Mask Pass/Fail

:FETCh:EMISsion:FAIL?

Returns the most recent spectral emission mask pass/fail measurement result.

Any violation of the spectral emission mask template will cause a FAIL result.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as a single value indicating the PASS/FAIL status of the spectral emission mask measurement (PASS = 0, FAIL = 1).

Default Units:

No units

 

Fetch Spectral Emission Mask Template

:FETCh:EMISsion:TEMPlate?

Returns the spectral emission mask template used for the most recent spectral emission mask measurement.

Any violation of the spectral emission mask template will cause a FAIL result.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Data is returned as a single value representing the template used for the current spectral emission mask measurement results.

Default Units:	No units
Templates	0	Power >= 43 dBm
	1	43 dBm > Power >= 39 dBm
	2	39 dBm > Power >= 31 dBm
	3	Power < 31 dBm

 

Fetch Occupied Bandwidth

:FETCh:OBWidth?

Returns the most recent occupied bandwidth measurement results.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Default Units:

Hz

 

Fetch Over The Air

:FETCh:OTA[1]|2|3|4|5|6?

Returns the most recent over-the-air measurement results.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

The measurement results are returned as 5 comma delimited values: scrambling code, CPICH power, chip energy, Ec/I0 ratio, pilot dominance.

If valid results are not available in the requested position (1-6), the returned string will contain a series of 3 dashes “---“ instead of the numeric results.

Default Units:

Scrambling Code: No units CPICH power: dBm Chip Energy: dBm EC/I0: dB Pilot dominance: No units

 

Fetch PASS/FAIL

:FETCh:PFail?

Returns the most recent PASS/FAIL measurement results.

If the instrument is actively measuring, it will not return until the measurement is complete. If the instrument is not actively measuring and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Measurement results are returned in a block of ASCII text in the format of <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 block consists of a set of records which indicate individual test results. Records are comma-separated. Each record follows the format <test ID>: <input1> <input2> <min> <max> <value1> <value2> <PASS/FAIL/OPTION NOT INSTALLED>. The <test ID> field indicates which test was performed to retrieve these results. The < input1> and < input2> fields indicate the test setup. The <min> and <max> fields indicate the minimum and maximum values against which <value1> and <value2> were compared to arrive at the final PASS/FAIL result.

If the specified test is not available in the instrument, the <PASS/FAIL> field will indicate “option not available” instead of “pass” or “fail”.

All unused fields for a given test will be represented by a double dash (“--“).

 

Fetch Peak to Average Power Ratio

:FETCh:PTAPower?

Returns the most recent peak to average power ratio measurement result.

If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

Default Units:

dB

 

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