READ

READ

Last updated: July 25, 2008

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.

Requirements

Test Application Revision: A.01.20 and above
Lab Application Revision: A.01 and above

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:ARQDemod[:ALL]?

Function

Initiates and fetches a demodulation of ARQ channel measurement as a sequential operation.

Measurement results are returned in the following order: integrity, P(ACK/NAK), P(NAK/ACK), NAK test error count, ACK test error count, NAK test tested count, ACK test tested count, NAK test confidence limit, ACK test confidence limit, NAK test confidence level, ACK test confidence level.

Requirements

Test Application Revision: A.08 and above
Lab Application Revision: A.05 and above

Query

Integrity

P(ACK/NAK)

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

P(NAK/ACK)

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

NAK Test Error Count

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

ACK Test Error Count

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

NAK Test Tested Count

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

ACK Test Tested Count

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

NAK Test Confidence Limit

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

ACK Test Confidence Limit

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

NAK Test Confidence Level

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

ACK Test Confidence Level

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

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.

Requirements

Test Application Revision: A.01.20 and above
Lab Application Revision: A.01 and above

Query

Integrity

Access probe power

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

READ:CFDTune[:ALL]?

Function

Initiates and fetches a fast device tune measurement as a sequential operation.

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

Number of Frequency Steps

  • Range: 1 to 20, 9.91 E+37

  • Resolution: 1.0

Number of Power Steps

  • Range: 1 to 20, 9.91 E+37

  • Resolution: 1.0

Number of MS Tx Power Steps Measured

  • Range: 1 to 400, 9.91 E+37

  • Resolution: 1.0

MS Tx Power Results Array

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

  • Resolution: 0.01 dBm

Requirement

Test Application Revision: A.06 and above, with the required feature license

Lab Application Revision: A.03 and above

READ:CPERror[:ALL]?

Function

Initiates and fetches the PER (packet error rate) measurement as a sequential operation.

This measurement returns up to 5 results in the following order:
integrity, confidence pass/fail, packet error rate, packet error count, packets tested.

See Packet Error Rate (PER) Measurement Description ).

Requirements

Test Application Revision: A.01.20 and above
Lab Application Revision: A.01 and above

Query

Integrity

Confidence Pass/Fail

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

Packet Error Rate

  • Range: 0.00 to 100.00, 9.91 E+37

  • Resolution: 0.01 %

Packet Error Count

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

  • Resolution: 1 packet

Packets Tested

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

  • Resolution: 1 packet

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] .

Requirements

Test Application Revision: A.01.20 and above
Lab Application Revision: A.01 and above

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.

Measurement result returns a comma separated list of 101 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.

Requirements

Test Application Revision: A.02.20 and above
Lab Application Revision: A.01 and above

Query

Integrity

Power result

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

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.

Requirements

Test Application Revision: A.01.20 and above
Lab Application Revision: A.01 and above

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 -80.00 dBc, 9.91 E+37

  • Resolution: 0.01 dBc

Upper adjacent channel spurious emissions

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

  • Resolution: 0.01 dBc

Lower alternate channel spurious emissions

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

  • Resolution: 0.01 dBc

Upper alternate channel spurious emissions

  • Range: 0.00 to -80.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] .

Requirements

Test Application Revision: A.01.20 and above
Lab Application Revision: A.01 and above

Query

Integrity

Digital average power:

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

READ:DOWQuality[: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 (in seconds), carrier feedthrough, phase error (in degrees), 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:DOWQuality:COUNt[:SNUMber] .

See Waveform Quality + Code Domain Measurement Description .

Requirements

Test Application Revision: A.01.20 and above
Lab Application Revision: A.01 and above

Query

Integrity

Rho

  • Range: 0.0000 to 1.0000, 9.91 E+37
  • Resolution: 0.0001

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.00 to 0.00 dBc, 9.91 E+37
  • Resolution: 0.01 dB

Phase Error

  • Range: 0.00 to 359.99 degrees, 9.91 E+37
  • 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%, 9.91 E+37
  • Resolution: 0.01%

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

Function

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

This query returns 21 comma-separated values, in the order of an overall integrity value, followed by 20 power results for the first 20 access probes.

If the measurement consists of less than 20 access probes, the remaining power results will be returned as 9.91 E+37, which means no results were available.

You can use FETCh:GAPPower[:ALL]:RANGe60? to query power results for up to 60 access probes.

The total number of the access probes measured is equal to Probe Sequence Max times Probe Num Step .

If the test set does not receive the expected number of access probes and no timeouts have been set up (see SETup:GAPPower:TIMeout[:STIMe] ), this command will hang indefinitely.

Requirements

Lab Application Revision: A.01 and above

Query

Integrity

Access probes

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

  • Resolution: 0.0000001 dBm

READ:GAPPower[:ALL]:RANGe60?

Function

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

This query returns 61 comma-separated values, in the order of an overall integrity value, followed by 60 power results for the first 60 access probes.

If the measurement consists of less than 60 access probes, the remaining power results will be returned as 9.91 E+37, which means no results were available.

You can use FETCh:GAPPower[:ALL][:RANGe20]? to query power results for up to 20 access probes.

The total number of the access probes measured is equal to Probe Sequence Max times Probe Num Step .

If the test set does not receive the expected number of access probes and no timeouts have been set up (see SETup:GAPPower:TIMeout[:STIMe] ), this command will hang indefinitely.

Requirements

Lab Application Revision: A.01 and above

Query

Integrity

Access probes

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

  • Resolution: 0.0000001 dBm

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.

Requirements

Test Application Revision: A.01.20 and above
Lab Application Revision: A.01 and above

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:SMONitor:TRACe?

Function

Initiates and fetches a spectrum monitor measurement as a sequential operation.Returns a comma separated list of 401 points representing the amplitude results of the trace data.

Requirements

Test Application Revision: A.01.20 and above
Lab Application Revision: A.01 and above

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: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.

Requirements

Test Application Revision: A.01.20 and above
Lab Application Revision: A.01 and above

Query

Integrity

Time Response of Open Loop Power Control

  • Range: 0, 1, 9.91 E+37