INITiate

Function

This command initiates (starts) the specified measurements:

• AFANalyzer - Audio Frequency Analyzer measurement

• ARQDemod - Demodulation of ARQ Channel measurement

• CAPPower - Access Probe Power measurement

• CFDTune - Fast Device Tune measurement ( lab application or feature-licensed test application only )
• CPERror - Packet Error Rate measurement

• CPOWer - Channel Power measurement

• CTDPower - TX Dynamic Power measurement

• CTXSpurious - TX Spurious Emissions measurement

• DAPower - Digital Average Power measurement

• DOWQuality - Waveform Quality measurement

• GAPPower - Graphical Access Probe Power measurement (lab application only)

• SAUDio - Swept Audio measurement

• SMONitor - Spectrum Monitor

• TROPower - Time Response of Open Loop Power Control measurement

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

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

See INITiate Programming Examples (how INIT commands are used) .

Programming Example

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

Function

Queries the arm state of the fast device tune measurement.

• This command immediately returns a 1 if the fast device tune measurement has been initiated and is ready to be triggered.
• This command hangs if the fast device tune measurement has been initiated but is not ready to be triggered (it will return a 1 once the measurement becomes ready to be triggered).
• This command immediately returns a 0 if the fast device tune measurement is not in the process of preparing for a trigger (for example, if the fast device tune measurement has not been initiated, has been aborted, or has already been triggered).

Query

Range: 0 | 1

Requirement

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

Lab Application Revision: A.03 and above

Programming Example

 
OUTPUT 714;"INITiate:CFDTune:ARMed?"
!Queries whether the test set's hardware is successfully
!set up for FDT measurement.

Function

Deactivates the selected measurement. See Measurement States .

Only one measurement can be deactivated at a time. See INITiate:<measurement mnemonic>[:ON] for a list of the measurement mnemonics.

To stop one or more measurements and leave them in the active state, use ABORt .

Programming Example

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

Function

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

Requirements

Query

Range: 0 to 10

Programming Example

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

Function

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

See INITiate Programming Examples (how INIT commands are used) and 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.

Range:

• AFAN - Audio Frequency Analyzer measurement

• ARQD - Demodulation of ARQ Channel measurement

• CAPP - Access Probe Power measurement

• CFDT - Fast Device Tune measurement ( Only applicable to the lab application or feature-licensed test application )

• CPER - Packet Error Rate measurement

• CPOW - Channel Power measurement

• CTDP - TX Dynamic Power measurement

• CTXS - TX Spurious Emissions measurement

• DAP - Digital Average Power measurement

• DOWQ - Waveform Quality measurement

• GAPP - Graphical Access Probe Power measurement ( Only applicable to the lab application )

• SAUD - Swept Audio measurement

• SMON - Spectrum Monitor

• TROP - Time Response of Open Loop Power Control 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.

Programming Example

 
OUTPUT 714;"INITiate:DONE?"
!Queries which measurements are finished

Function

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

Programming Example

 
OUTPUT 714;"INITiate:DONE:CLEar"
! Clears the done flag from all measurements

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

Programming Example

 
OUTPUT 714;"INITiate:DONE:FLAG INCLude" 

 
! Includes all measurements in the INITiate:DONE? query.

Function

Specifies if a measurement done flag is considered (using the INCLude or EXCLude settings) when the INITitate:DONE? query is sent. See INITiate:<measurement mnemonic>[:ON] for a list of the measurement 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:CONTinuous 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

*RST Setting

Programming Example

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

Function

Queries the measurements that are on. See Measurement States .

Returns a comma separated list of measurement mnemonics.

Query

Range:

• AFAN - Audio Frequency Analyzer measurement

• ARQD - Demodulation of ARQ Channel measurement

• CAPP - Access Probe Power measurement

• CFDTune - Fast Device Tune measurement

• CPER - Packet Error Rate measurement

• CPOW - Channel Power measurement

• CTDP - TX Dynamic Power measurement

• CTXS - TX Spurious Emissions measurement

• DAP - Digital Average Power measurement

• DOWQ - Waveform Quality measurement

• GAPPower - Graphical Access Probe Power measurement (lab application only)

• SAUD - Swept Audio measurement

• SMON - Spectrum Monitor

• TROP - Time Response of Open Loop Power Control measurement

• NONE - no measurements are on

Programming Example

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