INITiate

INITiate

Last updated: July 27, 2009

GPIB Command Conventions

INITiate<:measurement mnemonic>[:ON]

Function

These commands initiate (start) the specified measurements:

  • AFANalyzer - Audio Frequency Analyzer measurement
  • ATXPower - Analog Transmitter Power
  • CAPPower - Access Probe Power measurement
  • CCTPhase - Code Channel Time / Phase error measurement
  • CFDTune - Fast Device Tune measurement
  • CFERror - Frame Error Rate measurement
  • CMAudio - Multi-Tone Audio measurement
  • CMMPower - Maximum/Minimum Power measurement
  • CPOWer - Channel Power measurement
  • CTDPower - TX Dynamic Power measurement
  • CTXSpurious - TX Spurious Emissions measurement
  • DAPower - Digital Average Power measurement
  • DTMF - Dual Tone Multi-Frequency measurement
  • FM - Frequency Modulation measurement
  • FSTability - Frequency Stability measurement
  • GAPPower - Graphical Access Probe Power measurement (only applicable to the lab application)
  • GPOWer - Gated Power measurement
  • HWQuality - Handoff Waveform Quality measurement
  • PESQuality - Perceptual Evaluation of Speech Quality Measurement
  • SAUDio - Swept Audio measurement
  • SMONitor - Spectrum Monitor measurement
  • STONe - Signaling Tone measurement
  • TFERror - TDSO Frame Error Rate measurement
  • TROPower - Time Response of Open Loop Power Control measurement
  • WDDeviation - Wideband Data Deviation measurement
  • WQUality - Waveform Quality measurement

The INITiate command is associated with the SETup command, and the FETCh? command, see SETup Subsystem and FETCh? Subsystem .

One or more measurements can be initiated with the same program line (see Concurrent Measurements and the Programming Example below).

This command is also used to activate a measurement. See INITiate Programming Examples (how INIT commands are used) .

Requirement

Test Application Revision: B.07.15 and above added CMMPower and CTDPower
Lab Application Revision: B.01.16 and above added CMMPower and CTDPower

Test Application Revision: B.08 and above added CMAudio
Lab Application Revision: B.02 and above added CMAudio

Test Application Revision: B.09 and above added DTMF, STONe and WDDeviatoin
Lab Application Revision: B.03 and above added DTMF, STONe and WDDeviatoin

Test Application Revision: B.11 and above added CFDT
Lab Application Revision: B.04 and above added CFDT

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

Programming Example

 
OUTPUT 714;"INITiate:CPOWer;WQUality"
!Initiates a channel power and a waveform quality measurement.

INITiate<:measurement mnemonic>:OFF

Function

Deactivates the selected measurement. See INITiate<:measurement mnemonic>[:ON] for a list of measurements.

Only one measurement can be deactivated at a time. To stop one or more measurements and leave them in the active state, use ABORt . See Measurement States for details.

Requirement

Test Application Revision: B.07.15 and above added CMMPower and CTDPower
Lab Application Revision: B.01.16 and above added CMMPower and CTDPower

Test Application Revision: B.08 and above added CMAudio
Lab Application Revision: B.02 and above added CMAudio

Test Application Revision: B.09 and above added DTMF, STONe and WDDeviatoin
Lab Application Revision: B.03 and above added DTMF, STONe and WDDeviatoin

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

Programming Example

 
OUTPUT 714;"INITiate:CPOWer:OFF"
!Deactivates the channel power measurement.

INITiate:CFDTune:ARMed?

Function

 Queries the arm state of the fast device tune measurement. This command returns a one if the fast device tune measurement is successfully initiated, the MS Tx and Rx Freqency/Power Series is successfully built and the test set is ready for receiving an RF rise trigger from the AT. Otherwise, a zero is returned.

Query

Range: 1 | 0

Requirement

Test Application Revision: B.11 and above.
Lab Application Revision: B.04 and above.

Programming Example

 
OUTPUT 714;"INITiate:CFDT:ARMed?"
!Queries

INITiate:COUNt?

Function

Queries the number of measurements that have been initiated (are active). See Measurement States .

Query

Range: 0 to 10

Programming Example

 
OUTPUT 714;"INITiate:COUNt?"
!Queries the number of currently active measurements.

INITiate:DONE?

Function

Queries (one at a time) which measurements, if any, are finished or have timed-out.

See Measurement Event Synchronization for how to use this command.

See Measurement States to understand the test set's measurement states.

See INITiate:DONE:FLAG<:measurement mnemonic> for include or exclude commands.
Query

Range:

  • AFAN - Audio Frequency Analyzer measurement
  • ATXP - Analog Transmitter Power
  • CAPP - Access Probe Power measurement
  • CCTP - Code Channel Time/Phase error measurement
  • CFDT - Fast Device Tune measurement
  • CFER - Frame Error Rate measurement
  • CMA - Multi-Tone Audio measurement
  • CMMP - Maximum/Minimum Power measurement
  • CPOW - Channel Power measurement
  • CTDP - TX Dynamic Power measurement
  • CTXS - TX Spurious Emissions measurement
  • DAP - Digital Average Power measurement
  • DTMF - Dual Tone Multi-Frequency measurement
  • FM - Frequency Modulation measurement
  • FST - Frequency Stability measurement
  • GAPP - Graphical Access Probe Power measurement (only applicable to the lab application)
  • GPOW - Gated Power measurement
  • HWQ - Handoff Waveform Quality measurement
  • PESQuality - Perceptual Evaluation of Speech Quality Measurement
  • SAUD - Swept Audio measurement
  • SMON - Spectrum Monitor measurement
  • STON - Signaling Tone measurement
  • TFER - TDSO Frame Error Rate measurement
  • TROP - Time Response of Open Loop Power Control measurement
  • WDDeviation - Wideband Data Deviation measurement
  • WQU - Waveform Quality measurement
  • NONE - there are no measurements in the measuring state.
  • WAIT - there are one or more measurements in the measuring state, and none are ready to be fetched.

Requirement

Test Application Revision: B.07.15 and above added CMMPower and CTDPower
Lab Application Revision: B.01.16 and above added CMMPower and CTDPower

Test Application Revision: B.08 and above added CMAudio
Lab Application Revision: B.02 and above added CMAudio

Test Application Revision: B.09 and above added DTMF, STONe and WDDeviatoin
Lab Application Revision: B.03 and above added DTMF, STONe and WDDeviatoin

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

INITiate:DONE:CLEar

Function

Clears the done flag from all measurements. See INITiate:DONE? and INITiate:DONE:FLAG[:ALL] .

Requirement

Test Application Revision: B.07.15 and above added CMMPower and CTDPower
Lab Application Revision: B.01.16 and above added CMMPower and CTDPower

Test Application Revision: B.08 and above added CMAudio
Lab Application Revision: B.02 and above added CMAudio

Test Application Revision: B.09 and above added DTMF, STONe and WDDeviatoin
Lab Application Revision: B.03 and above added DTMF, STONe and WDDeviatoin

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

Programming Example

 
OUTPUT 714;"INITiate:DONE:CLEar" !Clears the done flag.

INITiate:DONE:FLAG[:ALL]

Function

Specifies that all measurements are either included or excluded when the INITitate:DONE? query is sent.

If a measurement trigger arm is left in continuous mode, the done flag for that measurement will toggle between DONE and WAIT. The INITiate:DONE? query will probably not be able to catch the measurement at the instant it is done; therefore, the measurement will never appear to be done. If a measurement's triggering must be continuously armed, you should exclude the measurement using INITiate:DONE:FLAG<:measurement mnemonic> .

Use INITitate:DONE:FLAG:ALL EXCLude to exclude all measurements.

Once INITiate:DONE:FLAG has been set to EXCLude for a measurement, the user must send the INCLude command for that measurement in order to query that measurement with the INITiate:DONE? query. The test set will not reset any excluded measurement with any type of preset.

Setting

Range: INCLude|EXCLude
*RST Setting

INCLude

Requirement

Test Application Revision: B.07.15 and above added CMMPower and CTDPower
Lab Application Revision: B.01.16 and above added CMMPower and CTDPower

Test Application Revision: B.08 and above added CMAudio
Lab Application Revision: B.02 and above added CMAudio

Test Application Revision: B.09 and above added DTMF, STONe and WDDeviatoin
Lab Application Revision: B.03 and above added DTMF, STONe and WDDeviatoin

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

Programming Example

 
OUTPUT 714;"INITiate:DONE:FLAG INCLude"
!Includes all measurements in the INITiate:DONE? query.

INITiate:DONE:FLAG<:measurement mnemonic>

Function

Specifies if a measurement done flag is considered (using the INCLude or EXCLude settings) when the INITiate:DONE? query is sent. See INITiate<:measurement mnemonic>[:ON] for a list of measurment mnemonics.

If more than one measurement is active, and one or more measurement trigger arm states is continuous, the INITiate:DONE? query may not be effective. The best solution is to change the arm state of all measurements to single using the SETup[:ALL]:CONTinuous<:OFF|:ON> command. However, if a measurement must be continuously triggered, you should exclude the measurement using the EXCLude setting provided by this command if you want to use INITiate:DONE? to query measurement done status.

The test set will not reset any excluded measurement to included with any type of preset.

Setting

Range: INCLude|EXCLude

Query

Range: INCL|EXCL

Requirement

Test Application Revision: B.07.15 and above added CMMPower and CTDPower
Lab Application Revision: B.01.16 and above added CMMPower and CTDPower

Test Application Revision: B.08 and above added CMAudio
Lab Application Revision: B.02 and above added CMAudio

Test Application Revision: B.09 and above added DTMF, STONe and WDDeviatoin
Lab Application Revision: B.03 and above added DTMF, STONe and WDDeviatoin

Test Application Revision: B.11 and above added CFDT
Lab Application Revision: B.04 and above added CFDT

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

Programming Example

 
OUTPUT 714;"INITIATE:DONE:FLAG:DAP EXCLUDE"
!Excludes the digital average power measurement from responding to the INITiate:DONE? query.

INITiate:ON?

Function

Queries the measurements that are on. Returns a comma separated list of measurement mnemonics.

Query

Range:

  • AFAN - Audio Frequency Analyzer measurement
  • ATXP - Analog Transmitter Power
  • CAPP - Access Probe Power measurement
  • CCTP - Code Channel Time/Phase error measurement
  • CFDT - Fast Device Tune measurement
  • CFER - Frame Error Rate measurement
  • CMA - Multi-Tone Audio measurement
  • CMMP - Maximum/Minimum Power measurement
  • CPOW - Channel Power measurement
  • CTDP - TX Dynamic Power measurement
  • CTXS - TX Spurious Emissions measurement
  • CTDP - TX Dynamic Power measurement
  • DAP - Digital Average Power measurement
  • DTMF - Dual Tone Multi-Frequency measurement
  • FM - Frequency Modulation measurement
  • FST - Frequency Stability measurement
  • GAPP - Graphical Access Probe Power measurement (only applicable to the lab application)
  • GPOW - Gated Power measurement
  • HWQ - Handoff Waveform Quality measurement
  • PESQuality - Perceptual Evaluation of Speech Quality Measurement
  • SAUD - Swept Audio measurement
  • SMON - Spectrum Monitor measurement
  • STON - Signaling Tone measurement
  • TFER - TDSO Frame Error Rate measurement
  • TROP - Time Response of Open Loop Power Control measurement
  • WDDeviation - Wideband Data Deviation measurement
  • WQU - Waveform Quality measurement
  • NONE - no measurements are on

Requirement

Test Application Revision: B.07.15 and above added CMMPower and CTDPower
Lab Application Revision: B.01.16 and above added CMMPower and CTDPower

Test Application Revision: B.08 and above added CMAudio
Lab Application Revision: B.02 and above added CMAudio

Test Application Revision: B.09 and above added DTMF, STONe and WDDeviatoin
Lab Application Revision: B.03 and above added DTMF, STONe and WDDeviatoin

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

Programming Example

 
OUTPUT 714;"INITiate:ON?" !Queries which measurements are on.