S331E, S332E, S361E, S362E Site Master™MS2711E, MS2712E, MS2713E Spectrum Master™MT8212E, MT8213E Cell Master™ Programming Manual : WCDMA Commands : :FETCh Subsystem
 
:FETCh Subsystem
This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement.
To make a new measurement, use the INITiate command. To get new measurement data, use the READ or MEASure query commands.
:FETCh:ACLR?
Title
Fetch Adjacent Channel Leakage Ratio
Description
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 Unit
dBm
:FETCh:CHPower?
Title
Fetch Channel Power/Density
Description
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 Unit
dBm
Related Command
:FETCh:CHPower:CHPower?
:FETCh:CHPower:DENSity?
:FETCh:DEMod:ACTChannels?
Title
Fetch Active Channel Count
Description
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 Unit
No Units
:FETCh:DEMod:CDPower?
Title
Fetch Demodulated Channel Power
Description
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 Unit
dBm
Related Command
:CONFigure:DEMod CDPower
:MEASure:DEMod:CDPower?
:READ:DEMod:CDPower?
Front Panel Access
Measurements, Demodulator, CDP
:FETCh:DEMod:CFTHrough?
Title
Fetch Carrier Feed Through
Description
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 Unit
dB
:FETCh:DEMod:EVM?
Title
Fetch Error Vector Magnitude (EVM)
Description
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 Unit
%
:FETCh:DEMod:FERRor:PPM?
Title
Fetch Frequency Error PPM
Description
Returns the most recent frequency error PPM 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 PPM.
Default Unit
No units
Related Command
MEASure:DEMod:FERRor:PPM?
READ:DEMod:FERRor:PPM?
:FETCh:DEMod:FERRor:PRECise?
Title
Fetch Frequency Error
Description
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. Note that this command is the same as :FETCh:DEMod:FERRor?, but returns the result with a precision of one-tenth Hertz.
Default Unit
Hertz
:FETCh:DEMod:FERRor?
Title
Fetch Frequency Error
Description
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 Unit
Hertz
:FETCh:DEMod:HSDPa:FERRor:PPM?
Title
Fetch HSDPA Frequency Error PPM
Description
Returns the most recent HSDPA frequency error PPM 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 HSDPA frequency error PPM.
Default Unit
No units
Related Command
MEASure:DEMod:HSDPa:FERRor:PPM?
READ:DEMod:HSDPa:FERRor:PPM?
:FETCh:DEMod:HSDPa:FERRor?
Title
Fetch HSDPA Frequency Error
Description
Returns the most recent HSDPA 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 HSDPA frequency error.
Default Unit
Hertz
:FETCh:DEMod:HSDPa:TXFRequency?
Title
Fetch HSDPA Transmitter Frequency
Description
Returns the most recent HSDPA 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 HSDPA carrier frequency.
Default Unit
Hertz
Related Command
:MEASure:DEMod:HSDPa:TXFRequency?
:READ:DEMod:HSDPa:TXFRequency?
:FETCh:DEMod:NFLoor?
Title
Fetch Code Domain Noise Floor
Description
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 Unit
dB
:FETCh:DEMod:NUMChannels?
Title
Fetch Total Channel Count
Description
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 Unit
No units
:FETCh:DEMod:SPOWer?
Title
Fetch Synch Channel Power
Description
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 Unit
dBm
:FETCh:DEMod:TXFRequency:PRECise?
Title
Fetch Transmitter Frequency
Description
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. Note that this command is the same as :FETCh:DEMod:TXFRequency?, but returns the result with a precision of one-tenth Hertz.
Default Unit
Hertz
:FETCh:DEMod:TXFRequency?
Title
Fetch Transmitter Frequency
Description
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 Unit
Hertz
:FETCh:EMISsion:FAIL?
Title
Fetch Spectral Emission Mask Pass/Fail
Description
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 Unit
No units
:FETCh:EMISsion:TEMPlate:DATA?
Title
Fetch Spectral Emission Mask Template Data
Description
Returns the spectral emission mask template power level, frequency, and PASS/FAIL data for all ten frequency ranges shown in the Spectral Emission Summary. 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. Any violation of the spectral emission mask template will cause a FAIL result.
For each frequency range, the data is returned as 3 comma delimited values: Power Level in dBm, Frequency in Hz, and PASS/FAIL. The order in which the data is returned is shown below (from top to bottom).
Range
-12.5 MHz to -8 MHz
-8 MHz to -4 MHz
-4 MHz to -3.515 MHz
-3.515 MHz to -2.715 MHz
-2.715 MHz to -2.515 MHz
2.515 MHz to 2.715 MHz
2.715 MHz to 3.515 MHz
3.515 MHz to 4 MHz
4 MHz to 8 MHz
8 MHz to 12.5 MHz
Related Command
MEASure:EMISsion:TEMPlate:DATA?
READ:EMISsion:TEMPlate:DATA?
:FETCh:EMISsion:TEMPlate?
Title
Fetch Spectral Emission Mask Template
Description
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.
Templates:
Template 0: Power >= 43 dBm
Template 1: 43 dBm > Power >= 39 dBm
Template 2: 39 dBm > Power >= 31 dBm
Template 3: Power < 31 dBm
Default Unit
No units
 
:FETCh:EMISsion?
Title
Fetch Spectral Emission Mask Results
Description
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 Unit
No units
Related Command
:FETCh:EMISsion:FAIL?
:FETCh:EMISsion:TEMPlate?
:FETCh:OBWidth?
Title
Fetch Occupied Bandwidth
Description
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 Unit
Hz
:FETCh:OTA{1|2|3|4|5|6}?
Title
Fetch Over The Air
Description
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 Unit
Scrambling Code: No units
CPICH power: dBm
EC/I0: dB
Chip Energy: dBm
Pilot dominance: No units
:FETCh:PFail?
Title
Fetch PASS/FAIL
Description
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 are represented by a double dash (“--”).
Related Command
MEASure:PFail?
:CONFigure PFail
READ:PFail?
:FETCh:PTAPower?
Title
Fetch Peak to Average Power Ratio
Description
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 Unit
dB