READ

READ

Last updated: July 24, 2009

GPIB Command Conventions

READ:AFANalyzer[:ALL]?

Function

Initiates and fetches an audio frequency analyzer measurement as a sequential operation.

Measurement results are returned in the following order: integrity, average audio level, average SINAD, average audio distortion.

Query

Integrity

Average audio level

  • Range: 0 to 20 volts, 9.91 E+37
  • Resolution: the lesser of 4 significant digits or 10 uV.

Average SINAD

  • Range: -99.00 to 99.00 dB, 9.91 E+37
  • Resolution: 0.01 dB

Average audio distortion

  • Range: 0.00 to 99.00%, 9.91 E+37
  • Resolution: 0.01%

READ:ATXPower[:ALL]?

Function

Initiates and fetches an analog transmitter power measurement as a sequential operation.

Measurement results are returned in the following order: integrity, average analog power.

Query

Integrity

Average analog transmitter power

  • Range: -100.00 to 100.00 dBm, 9.91 E+37
  • Resolution: 0.01 dB

READ:CAPPower[:ALL]?

Function

Initiates and fetches an access probe power measurement as a sequential operation.

Measurement results are returned in the following order: integrity, access probe power.

Query

Integrity

Access probe power

  • Range: -100.00 to 100.00 dBm, 9.91 E+37
  • Resolution: 0.01 dB

READ:CCTPhase[:ALL]?

Function

Initiates and fetches a code channel time and phase error measurement as a sequential operation.

Measurement results are returned in the following order: integrity, time error pass/fail indication, phase error pass/fail indication.

Query

Integrity

Time error pass/fail indicator:

  • Range: 0 (pass), 1 (fail), 9.91 E+37

Phase error pass/fail indicator:

  • Range: 0 (pass), 1 (fail), 9.91 E+37

READ:CFDTune[:ALL]?

Function

Queries the fast device tune (FDT) measurement results.

Results are returned in the following order:

  • Integrity
  • Number of Frequency Steps
  • Number of Power Steps
  • Number of MS TX power steps measured (in most cases, it equals Number of Frequency Steps multiplied by Number of Power Steps )
  • Comma-separated list of 400 MS Tx Power results. 400 results are always returned; if the test set measured fewer than 400 power steps from the mobile, the remaining values are NANs (9.91E+37). The power results for the first frequency in the MS TX Frequency Sequence are returned first, then the power results for the second frequency in the MS TX Frequency Sequence, etc., followed by NANs if fewer than 400 points were measured.

See Fast Device Tune Measurement Results .

Query

Integrity

Frequency Step Count

  • Range: 1 to 20, 9.91 E+37 (NAN)

  • Resolution: 1

Power Step Count

  • Range: 1 to 20, 9.91 E+37 (NAN)

  • Resolution: 1

Number of Steps in MS Tx Power Results

  • Range: 1 to 400, 9.91 E+37 (NAN)

  • Resolution: 1

MS Tx Power Results Array

  • Range: -100.00 to +100.00 dBm, 9.91 E+37 (NAN)

  • Resolution: 0.01 dBm

Requirements

Test Application Revision: B.11 and above, with the required feature license

Lab Application Revision: B.04 and above

READ:CFERror[:ALL]?

Function

Initiates and fetches the FER (frame error rate) measurements as a sequential operation.

FER measurement results are returned in the following order: integrity, confidence limit pass/fail result, frame error ratio, frame error count, frames tested.

Query

Integrity

Confidence limit pass/fail result

  • Range: 0 to 2 (0 = passed, 1 = failed, 2 = max frames), 9.91 E+37

Frame error ratio

  • Range: 0.00 to 100.00, 9.91 E+37

  • Resolution: 0.01 %

Frame error count

  • Range: 0 to 10,000,000, 9.91 E+37

  • Resolution: 1 frame

Frames tested

  • Range: 0 to 10,000,000, 9.91 E+37

  • Resolution: 1 frame

READ:CMAudio[:ALL]?

Function

Initiates and fetches a multi-tone audio measurement as a sequential operation.

Measurement results are returned in the following order: integrity, and a comma separated list of all multi-tone audio measured levels for all 20 audio tones (in dB unit).

For the levels, the query will return NAN (9.91E+37) for any audio tone that is turned off. For downlink audio measurements, the audio tones are turned off and on by SETup:CMAudio:GENerator:FREQuency:DOWNlink:PRESet . For uplink audio measurements, the audio tones can be turned off and on by SETup:CMAudio:GENerator:FREQuency:Uplink:PRESet , SETup:CMAudio:GENerator:FREQuency:Uplink:ALL[:SVALue] , or SETup:CMAudio:GENerator:LEVel:UPLink:ALL[:SAMPlitude] .

Query

Integrity

Multi-Tone Audio measured level

  • Range: -100 to +100 dB (for each tone)
  • Resolution: 0.1 dB

Requirements

Test Application Revision: B.08 and above.

Lab Application Revision: B.02 and above.

READ:CMMPower[:ALL]?

Function

Initiates and fetches the maximum/minimum power measurement as a sequential operation.

Measurement results are returned in the following order: integrity, maximum power result, minimum power result.

Query

Integrity

Maximum power

  • Range: -100.00 to 100.00 dBm, 9.91 E+37
  • Resolution: 0.01 dB

Minimum power

  • Range: -100.00 to 100.00 dBm, 9.91 E+37
  • Resolution: 0.01 dB

Requirements

Test Application Revision: B.07 and above.

Lab Application Revision: B.01 and above.

READ:CPOWer[:ALL]?

Function

Initiates and fetches a channel power measurement as a sequential operation.

Measurement results are returned in the following order: integrity, average channel power.

If the multi-measurement state is on, the result represents the average of a number of channel power measurements. Multi-measurement state, by default, is off. To set up multi-measurements, see SETup:CPOWer:COUNt[:SNUMber] .

Query

Integrity

Channel power

  • Range: -100.00 to 100.00 dBm, 9.91 E+37
  • Resolution: 0.01 dB

READ:CTDPower[:ALL]?

Function

Initiates and fetches Tx dynamic power measurement as a sequential operation.

This query returns 101 comma-separated values, in the order of an integrity value followed by 100 power results. If the dynamic power measurement consists of less than 100 measurement steps (determined by FETCh:CTDPower:COUNt[:STEP]? ), the query results will be padded with NAN's (9.91 E+37), which means no results were available.

Query

Integrity

Channel power

  • Range: -100.00 to 100.00 dBm, 9.91 E+37
  • Resolution: 0.01 dB

Requirements

Test Application Revision: B.07 and above.

Lab Application Revision: B.01 and above.

READ:CTXS purious[:ALL]?

Function

Initiates and fetches the TX spurious emission measurement as a sequential operation.

FER measurement results are returned in the following order: integrity,TX spurious emission pass/fail result, lower adjacent channel (-0.885 or -1.25 MHz) average spurious emissions, upper adjacent channel (+0.885 or +1.25 MHz) average spurious emissions, lower alternate channel (-1.98 MHz) average spurious emissions, upper alternate channel (+1.98 MHz) average spurious emissions.

Query

Integrity

TX spurious emissions pass/fail result

  • Range: 0 to 1 (0 = passed, 1 = failed), 9.91 E+37

Lower adjacent channel spurious emissions

  • Range: 0.00 to -70.00 dBc, 9.91 E+37

  • Resolution: 0.01 dBc

Upper adjacent channel spurious emissions

  • Range: 0.00 to -70.00 dBc, 9.91 E+37

  • Resolution: 0.01 dBc

Lower alternate channel spurious emissions

  • Range: 0.00 to -70.00 dBc, 9.91 E+37

  • Resolution: 0.01 dBc

Upper alternate channel spurious emissions

  • Range: 0.00 to -70.00 dBc, 9.91 E+37

  • Resolution: 0.01 dBc

READ:DAPower[:ALL]?

Function

Initiates and fetches a digital average power measurement as a sequential operation.

Measurement results are returned in the following order: integrity, digital average transmit power.

If the multi-measurement state is on, the result represents the average of a number of digital average power measurements. Multi-measurement state, by default, is off. To set up multi-measurements, see SETup:DAPower:COUNt[:SNUMber] .

Query

Integrity

Digital average power:

  • Range: -100.00 to 100.00 dBm, 9.91 E+37
  • Resolution: 0.01 dB

READ:DTMF[:ALL]?

Function

Initiates and fetches the a DTMF measurement as a sequential operation.

Measurement results are returned in the following order: integrity, number of characters, then 16 sets of 9 comma-separated values in the following order: character n symbol, character n low tone frequency, character n low tone frequency error, character n low tone phase deviation, character n high tone frequency, character n high tone frequency error, Character n high tone phase deviation, character n on time, character n off time. n is from 0 to 15.

Query

Integrity

Number of characters

  • Range: 0 to 16

  • Resolution: 1

Character n Symbol

  • Range: 0 to 15, 9.91 E+37

    The result is a numeric real result corresponding to actual character result 0 to 9, A, B, C, D, * and #.

Character n Low Tone Frequency

  • Range: 0 Hz to 999 Hz, 9.91 E+37

Character n Low Tone Frequency Error

  • Range: -99 Hz to 99 Hz, 9.91 E+37

Character n Low Tone Phase Deviation

  • Range: 0 to 9 Radians, 9.91 E+37

Character n High Tone Frequency

  • Range: 0 to 2,000 Hz, 9.91 E+37

Character n High Tone Frequency Error

  • Range: -99 to 99 Hz, 9.91 E+37

Character n High Tone Phase Deviation

  • Range: 0 to 9 Radians, 9.91 E+37

Character n On Time

  • Range: 0 to 6,000 ms, 9.91 E+37

Character n Off Time

  • Range: 0 to 6,000 ms, 9.91 E+37

Requirements

Test Application Revision: B.09 or above

Lab Application Revision: B.03 or above

READ:FM[:ALL]?

Function

Initiates and fetches an FM measurement as a sequential operation.

Measurement results are returned in the following order: integrity, average frequency deviation, average distortion.

The distortion measurement must be enabled before a measurement result (other than 9.91E+37) is reported. See SETup:AFANalyzer:SDIStortion:STATe .

Query

Integrity

Average FM frequency deviation

  • Range: 0.000 to 99.000 kHz, 9.91 E+37
  • Resolution: 0.001 Hz

Average FM distortion

  • Range :0.0 to 100.0%, 9.91 E+37
  • Resolution: 0.1%

Average FM frequency

  • Range: 0.0 to 99999.0 Hz, 9.91 E+37

  • Resolution: 0.1 Hz

READ:GAPPower[:ALL][:RANGe20]?

Function

Initiates and fetches a graphical access probe power measurement cycle as a sequential operation.

This measurement returns results in the following order: integrity, followed by a comma-separated list of 20 access probe power results.

If the graphical access probe power measurement consisted of less than 20 access probes, the query results will be padded with NAN's (9.91 E37) to make the number of measurements equal 20.

If the test set does not receive the expected number of access probes and no timeouts have been set up this command will hang indefinitely.

Query

Integrity

Access probes

  • Range: -100 to 100 dBm, 9.91 E+37

  • Resolution: 0.0000001 dBm

Requirements

Lab Application Revision: A.01 and above

READ:GAPPower[:ALL]:RANGe60?

Function

Initiates and fetches a graphical access probe power measurement cycle as a sequential operation.

This measurement returns results in the following order: integrity, followed by a comma-separated list of 60 access probe power results.

If the graphical access probe power measurement consisted of less than 60 access probes, the query results will be padded with NAN's (9.91 E37) to make the number of measurements equal 60.

If the test set does not receive the expected number of access probes and no timeouts have been set up this command will hang indefinitely.

Query

Integrity

Access probes

  • Range: -100 to 100 dBm, 9.91 E+37

  • Resolution: 0.0000001 dBm

Requirements

Lab Application Revision: A.02 and above

READ:FSTability[:ALL]?

Function

Initiates and fetches a frequency stability measurement as a sequential operation.

Measurement results are returned in the following order: integrity, worst-case frequency error, average frequency.

Query

Integrity

Worst-case frequency error

  • Range: -500.00 to 500.00 parts per million (ppm), 9.91 E+37
  • Resolution: 0.01

Average frequency

  • Range: 100 E+6 to 3 E+9 Hz, 9.91 E+37
  • Resolution: 1 Hz

READ:GPOWer[:ALL]?

Function

Initiates and fetches a gated power measurement as a sequential operation.

Measurement results are returned in the following order: integrity, gated power pass/fail indication.

Query

Integrity

Pass/fail indicator:

  • Range: 0 (pass), 1 (fail), 9.91 E+37

READ:HWQuality[:ALL]?

Function

Initiates and fetches the handoff waveform quality measurements as a sequential operation.

Measurement results are returned in the following order: integrity, rho, frequency error, time error, carrier feedthrough, phase error, magnitude error.

Query

Integrity

  • Range: 0 to 31

  • Resolution: 1

Rho

  • Range: 0.000 to 1.000, 9.91 E+37

  • Resolution: 0.001

Frequency Error

  • Range: -9999.0 to 9999.0 Hz, 9.91 E+37

  • Resolution: 0.1 Hz

Time Error

  • Range: -99.99 E-6 to 99.99 E-6 s, 9.91 E+37

  • Resolution: 0.01 E-6 s

Carrier Feedthrough

  • Range: -100 to 0.0 dB, 9.91 E+37

  • Resolution: 0.1

Phase Error

  • Range: 0.00 to 359.99 degrees

  • Resolution: 0.01

Magnitude Error

  • Range: 0 to 100%, 9.91 E+37

  • Resolution: 0.01

READ:PESQuality[:ALL]?

Function

Initiates and fetches the Perceptual Evaluation of Speech Quality Measurement as a sequential operation.

Measurement results are returned in the following order: Integrity, Uplink PESQ Score, Downlink PESQ Score,PESQ Uplink Headroom, PESQ Downlink Headroom.

Query

Integrity

  • Range: 0 to 31
  • Resolution: 1

Uplink PESQ Score

  • Range: -0.5 to 4.5, 9.91 E+37
  • Resolution: 0.01

Downlink PESQ Score

  • Range: -0.5 to 4.5, 9.91 E+37
  • Resolution: 0.01

PESQ Uplink Headroom

  • Range: 0.0 to 100.0 dB, 9.91 E+37
  • Resolution: 0.1 dB

PESQ Downlink Headroom

  • Range: 0.0 to 100.0 dB, 9.91 E+37
  • Resolution: 0.1 dB

Requirement

Test Application Revision: B.16.00 and above with the required feature license

Programming Example

 
OUTPUT 714;"READ:PESQuality:ALL?"
!Initiates and fetches the Perceptual Evaluation of Speech Quality Measurement.

READ:SAUDio[:ALL]?

Function

Initiates and fetches a swept audio measurement as a sequential operation.

Measurement results are returned in the following order: integrity, and a comma separated list of average audio level and average audio distortion for each frequency point in the sweep.

For frequencies about 10 kHz, the measurement will return 9.91 E+37.

Query

Integrity

Average Audio Level

  • Range: 1 mV to 20 V, 9.91 E+37
  • Resolution: the lesser of 4 significant digits or 10 uV

Average Audio Distortion

  • Range: 0 to 99.9%, 9.91E+37
  • Resolution: 0.1

READ:STONe[:ALL]?

Function

Initiates and fetches the signaling tone measurements as a sequential operation.

Measurement results are returned in the following order: integrity, positive peak deviation, negative peak deviation, frequency error and frequency.

When multi-measurement is enabled, the average positive peak deviation, average negative peak deviation, average frequency error and average frequency from all the measurements are returned.

Query

Integrity

Average positive peak deviation

  • Range: -20 to 20 kHz, 9.91 E+37

Average negative peak deviation

  • Range: -20 to 20 kHz, 9.91 E+37

Average frequency error

  • Range: -10,000 Hz to 10,000 Hz, 9.91 E+37

Average frequency

  • Range: 0 to 20,000 Hz, 9.91 E+37

Requirements

Test Application Revision: B.09 or above

Lab Application Revision: B.03 or above

READ:SMONitor:TRACe?

Function

Queries (initiates and fetches) one spectrum monitor measurement as a sequential operation.

Returns a comma separated list of 401 points representing the amplitude results of the trace data.

Query

Range:

  • For spans of 125 kHz and 500 kHz

    • frequency of point: within the current span (relative to the center frequency)
    • amplitude of point: -50 to +55 dB
  • For all other spans

    • frequency of point: within the current span (relative to the center frequency)
    • amplitude of point: (reference level - 60 dB) to +55 dB

READ:TFERror[:ALL]?

Function

Initiates and fetches the TDSO FER (test data service option (SO32) frame error rate) measurements as a sequential operation.

FER measurement results are returned in the following order: integrity, frame error rate (%), received good frames, received blank frames, transmitted good frames, transmitted blank frames, frame error rate confidence (%).

Query

Integrity

Frame error rate

  • Range: 0.00 to 100.00, 9.91 E+37

  • Resolution: 0.01 %

Received good frames

  • Range: 0 to 999936, 9.91 E+37

Transmitted blank frames

  • Range: 0 to 999936, 9.91 E+37

Received good frames

  • Range: 0 to 999936, 9.91 E+37

Transmitted blank frames

  • Range: 0 to 999936, 9.91 E+37

Frame error rate confidence

  • Range: 0.00 to 100.00, 9.91 E+37

  • Resolution: 0.01 %

READ:TROPower[:ALL]?

Function

Initiates and fetches a time response of open loop power control measurement as a sequential operation.

Measurement results are returned in the following order: integrity, time response of open loop power control pass/fail result. For the pass/fail result, 0 = pass, 1 = fail, 9.91 E+37 = undefined.

Query

Integrity

Time Response of Open Loop Power Control

  • Range: 0, 1, 9.91 E+37

READ:WDDeviation[:ALL]?

Function

Initiates and fetches the Wideband Data Deviation measurement as a sequential operation.

Measurement results are returned in the following order: integrity, maximum positive peak frequency deviation, maximum negative peak frequency deviation, settled positive peak frequency deviation, settled negative peak frequency deviation.

If the measurement gets more than one wideband data burst, it measures the first one.

Query

Integrity

Maximum positive peak frequency deviation

  • Range: 0 to 20 kHz, 9.91 E+37

Minimum negative peak frequency deviation

  • Range: 0 to 20 kHz, 9.91 E+37

Settled positive peak frequency deviation

  • Range: 0 Hz to 20 kHz, 9.91 E+37

Settled negative peak frequency deviation

  • Range: 0 to 20 kHz, 9.91 E+37

Requirements

Test Application Revision: B.09 or above

Lab Application Revision: B.03 or above

READ:WQUality[:ALL]?

Function

Initiates and fetches the waveform quality measurements as a sequential operation.

Measurement results are returned in the following order: integrity, rho, frequency error, time error, carrier feedthrough, phase error, magnitude error, EVM.

If the multi-measurement state is on, each result represents the average of a number of waveform quality measurements. Multi-measurement state, by default, is off. To set up multi-measurements, see SETup:WQUality:COUNt[:SNUMber] .

Query

Integrity

  • Range: 0 to 31
  • Resolution: 1

Rho

  • Range: 0.000 to 1.000, 9.91 E+37
  • Resolution: 0.001

Frequency Error

  • Range: -9999.0 to 9999.0 Hz, 9.91 E+37
  • Resolution: 0.1 Hz

Time Error

  • Range: -99.99 E-6 to 99.99 E-6 s, 9.91 E+37

  • Resolution: 0.01 E-6 s

Carrier Feedthrough

  • Range: -100.0 to 0.0 dB, 9.91 E+37
  • Resolution: 0.1 dB

Phase Error

  • Range: 0.00 to 359.99 degrees
  • Resolution: 0.01 degrees

Magnitude Error

  • Range: 0.00 to 100.00%, 9.91 E+37
  • Resolution: 0.01%

Error Vector Magnitude (EVM)

  • Range: 0.00 to 100.00%
  • Resolution: 0.01%