FETCh:PCALibration

FETCh:PCALibration

Last updated: December 3, 2008

GPIB Command Conventions

FETCh:PCALibration[:ALL]?

Function

GSM TA

This query is only applicable when the Waveform Type is set to DISCrete , and the Result Type is set to PCAL .

See Phase and Amplitude Measurement Results for a Discrete Waveform for more information.

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration?" 
! If the Waveform Type is DISCrete and the Result Type is PCAL: This query returns 
! Integrity Indicator, Power, Phase Error and Frequency Error. 
 

FETCh:PCALibration:FERRor?

Function

GSM TA

This query is only applicable when the Waveform Type measured was a DISCrete waveform and the result type setting is PCAL or BOTH . The command to set the waveform type is SETup:PCALibration:WAVeform:TYPE , and the command to set the result type is SETup:PCALibration:RESult:TYPE .

This command queries the Frequency measurement result array. This array is identical to the Frequency array returned by the command FETCh:PCALibration[:ALL]? . The first value returned in the frequency array is the frequency (Hz) offset relative to the expected input frequency and all subsequent values in the array are frequency values relative to the first value returned (from the first measurement interval).

You can set/query the number of results that are returned in this array using the command SETup:PCALibration:MEASurement:COUNt .

For more information, see Phase and Amplitude Measurement Results for a Discrete Waveform .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:FREQuency?" 
! Queries the Frequency measurement result array for the Discrete waveform.

FETCh:PCALibration:INTegrity?

Function

GSM TA

This command queries the Integrity Indicator for the Phase and Amplitude versus Time measurement.

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:INTegrity?" 
! Queries the Integrity Indicator value for the Phase and Amplitude versus Time measurement.

FETCh:PCALibration:PHASe?

Function

GSM TA

This command queries the Phase measurement result array. This array is identical to the Phase array returned by the command FETCh:PCALibration[:ALL]? . The initial phase value in the phase array is 0° and all subsequent phase measurements are the phase relative to 0°. The unit of measurement for the phase results is degrees.

This query is only applicable when the Waveform Type measured was a DISCrete waveform and the result type setting is PCAL . The command to set the waveform type is SETup:PCALibration:WAVeform:TYPE , and the command to set the result type is SETup:PCALibration:RESult:TYPE

You can set/query the number of results that are returned in this array using the command SETup:PCALibration:MEASurement:COUNt .

For more information, see Phase and Amplitude Measurement Results for a Discrete Waveform .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:PHASe?" 
! Queries the Phase measurement result array for the Discrete waveform.

FETCh:PCALibration:POWer?

Function

GSM TA

This query is only applicable when the Waveform Type measured was a DISCrete waveform and the result type setting is PCAL . The command to set the waveform type is SETup:PCALibration:WAVeform:TYPE , and the command to set the result type is SETup:PCALibration:RESult:TYPE .

This command queries the Power measurement result array. This array is identical to the Power array returned by the command FETCh:PCALibration[:ALL]? . The first value returned in the power array is the absolute power measurement (in dBm), and all subsequent results in the array are relative power measurements (in dB) to the initial absolute power value.

You can set/query the number of results that are returned in this array using the command SETup:PCALibration:MEASurement:COUNt .

For more information, see Phase and Amplitude Measurement Results for a Discrete Waveform .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:Power?" 
! Queries the Power measurement results for the Discrete waveform.

FETCh:PCALibration:REFerence:POWer?

Function

GSM TA

This command is only applicable when the Waveform Type parameter is set to CONTinuous or CONT2.

This command queries the average power measurement (dBm) of the initial reference burst.

The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:REFerence:Power?" 
! Queries the Power results for the refernce burst on which the measurement is triggered.

FETCh:PCALibration:SAMPle:AMPLitude? <range>

Function

GSM TA

This command queries the Amplitude (normalized*) results in blocks of 1000. The amplitude results are normalized voltages.

If you wish to have the results returned in dBm, use the command FETCh:PCALibration:SAMPle:AMPLitude:DBM? <range> .

The total number of amplitude measurement results can be determined by using the FETCh:PCALibration:SAMPle:COUNt? query.

If the Waveform Type is DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

The range of <range> is 1 to N, where N is the Sample Count/1000 rounded up to the nearest integer. For example, if the Sample Count is 15,366 samples, then N is 16.

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:AMPLitude? 2" 
! Queries the Power measurement results for samples 1001 through 2000.

FETCh:PCALibration:SAMPle:AMPLitude:BINary?

Function

GSM TA

This query returns amplitude (sqrt(mW)) results as an IEEE 488 definite length arbitrary block. Each amplitude result in the payload of the arbitrary block is a 32 bit floating point (IEEE 754 format) number expressing the sample amplitude in Volts.

The number of amplitude results in the block can be determined by querying FETCh:PCALibration:SAMPle:COUNt? .

This command is only applicable when the Waveform Type is set to CONTinuous or if the waveform type is set to DISCrete and the result type is SAMPle or BOTH . The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:AMPLitude:BINary?" 
! Queries the all Power measurement results (in Volts) and returns them in binary format.

FETCh:PCALibration:SAMPle:AMPLitude:DBM? <range>

Function

GSM TA

This command queries the amplitude (in dBm) results in blocks of 1000. The amplitude results are normalized voltages.

The total number of amplitude measurement results can be determined by using the FETCh:PCALibration:SAMPle:COUNt? query.

If the Waveform Type is DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

The range of <range> is 1 to N, where N is (0.5 plus Sample Count)/1000 rounded up to the nearest integer. For example, if the Sample Count is 15,366 samples, then N is 16.

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:AMPLitude:dBm? 2" 
! Queries the Power measurement results(in dBm) for samples 1001 through 2000.

FETCh:PCALibration:SAMPle:AMPLitude:DBM:BINary?

Function

GSM TA

This query returns amplitude (dBm) results as an IEEE 488 definite length arbitrary block. Each amplitude result in the payload of the arbitrary block is a 32 bit floating point (IEEE 754 format) number expressing the sample amplitude in dBm.

The number of amplitude results in the block can be determined by querying FETCh:PCALibration:SAMPle:COUNt? .

If the Waveform Type is DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:AMPLitude:DBM:BINary?" 
! Queries the all Power measurement results (in dBm) and returns them in binary format.

FETCh:PCALibration:SAMPle:AMPLitude:MAXimum?

Function

GSM TA

This query returns the Amplitude (normalized*) of the sample with the largest amplitude.

If the Waveform Type is DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:AMPLitude:MAXimum?" 
! Queries the sample with the largest amplitude (units are sqrt(mW)).

FETCh:PCALibration:SAMPle:AMPLitude:MAXimum:DBM?

Function

GSM TA

This query returns the amplitude (in dBm) of the sample with the largest amplitude.

If the Waveform Type is DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:AMPLitude:MAXimum:DBM?" 
! Queries the sample with the largest amplitude (returns result in dBm).

FETCh:PCALibration:SAMPle:AMPLitude:MINimum?

Function

GSM TA

This query returns the Amplitude (normalized*) of the sample with the smallest amplitude.

If the Waveform Type DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:AMPLitude:MINimum?" 
! Queries the sample with the smallest amplitude (units are sqrt(mW)).

FETCh:PCALibration:SAMPle:AMPLitude:MINimum:DBM?

Function

GSM TA

This query returns the amplitude (in dBm) of the sample with the smallest amplitude.

If the Waveform Type DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:AMPLitude:MINimum:DBM?" 
! Queries the sample with the smallest amplitude (returns the result in dBm).

FETCh:PCALibration:SAMPle[:ALL]:BINary?

Function

GSM TA

This query returns sample amplitude (sqrt(mW)) and phase (Degrees) results as an IEEE 488 definite length arbitrary block. The payload of the arbitrary block contains amplitude/phase pairs, each pair comprising an amplitude result (Volts) followed by a phase result (Hz). Each result is a 32 bit floating point number (IEEE 754 format).

The number of amplitude/phase pairs in the block can be determined by using the query FETCh:PCALibration:SAMPle:COUNt? .

If the Waveform Type is DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle[:ALL]:BINary" 
! Queries all the Power (Volts) and Phase measurement results and returns them in binary format.

FETCh:PCALibration:SAMPle:COUNt?

Function

GSM TA

This command queries the number of results available.

If the Waveform Type parameter is set to DISCrete, this command is only applicable when the Result type parameter is set to SAMPle. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:COUNt?" 
! Queries the number of samples the measurement tested.

FETCh:PCALibration:SAMPle[:ALL]:DBM:BINary?

Function

GSM TA

This query returns amplitude (dBm) and phase (Degrees) results as an IEEE 488 definite length arbitrary block. The payload of the arbitrary block contains amplitude/phase pairs, each pair comprising an amplitude result (dBm) followed by a phase result (Hz). Each result is a 32 bit floating point number (IEEE 754 format). The number of amplitude/phase pairs in the block can be determined by querying FETCh:PCALibration:SAMPle:COUNt? .

If the Waveform Type is DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle[:ALL]:DBM:BINary?" 
! Queries the all the Power measurement and Phase results (dBm) and returns the results 
! in binary format.

FETCh:PCALibration:SAMPle:PHASe? <range>

Function

GSM TA

This command queries the phase measurement results (Degrees) in blocks of 1000. The total number of phase measurement results can be determined by using the FETCh:PCALibration:SAMPle:COUNt? query.

If the Waveform Type is DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE and the command to set the result type parameter is SETup:PCALibration:RESult:TYPE .

The range of <range> is 1 to N, where N is the Sample Count/1000 rounded up to the nearest integer. For example, if the Sample Count is 15,366 samples, then N is 16.

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:PHASe? 8" 
! Queries the Phase measurement results for samples 8001 through 9000.

FETCh:PCALibration:SAMPle:PHASe:BINary?

Function

GSM TA

This query returns phase (Degrees) results as an IEEE 488 definite length arbitrary block. Each phase result in the payload of the arbitrary block is a 32 bit floating point (IEEE 754 format) number expressing the sample phase in Degrees.

The number of phase results in the block can be determined by querying FETCh:PCALibration:SAMPle:COUNt? query.

If the Waveform Type is DIScrete , the result type must be SAMPle or BOTH to obtain these results. The command to set the waveform type parameter is SETup:PCALibration:WAVeform:TYPE and the command to set the result type parameter is SETup:PCALibration:RESult:TYPE .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements

GSM/GPRS/
EGPRS TA

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

GSM/GPRS/
EGPRS LA

Revision: D.03.32 and above

Programming Example

 
OUTPUT 714;"FETCh:PCALibration:SAMPle:PHASe:BINary?" 
! Queries all the sampled Phase measurement results and returns them in binary format.