INITiate

INITiate

Last updated: December 29, 2009

GPIB Command Conventions

INITiate:<measurement mnemonic>[:ON]

Function

These commands initiate (start) the following measurements:

  • AFANalyzer - Audio Frequency Analyzer measurements
  • CFDTune - Fast Device Tune measurement ( lab application or feature-licensed test application only )
  • EVMQpsk - QPSK EVM measurement ( lab application only )
  • FSTability - Frequency Stability measurement
  • HBLerror - HSDPA Block Error Ratio ( lab application or feature-licensed test application only )
  • HRCQuality - HSDPA Reporting of Channel Quality Indicator measurement ( lab application only )
  • SAUDio - Swept Audio measurement
  • SMONitor - Spectrum Monitor measurement
  • WACLeakage - Adjacent Channel Leakage
  • WBERror - Loopback Bit Error Ratio measurement
  • WBLerror - Block Error Ratio measurement
  • WCDomain - Code Domain measurements
  • WCPower - Channel Power measurement
  • WCTFormat - Change of TFC ( lab application only )
  • WDPAnalysis - Dynamic Power Analysis
  • WEDPower - Extended Range Dynamic Power
  • WILPower - Inner Loop Power measurement
  • WIQTuning - IQ Tuning measurement
  • WOBWidth - Occupied Bandwidth measurement
  • WOOPower - PRACH Transmit On/Off Power measurement
  • WOOSynch - Out-of-Synch Handling of Output Power measurement
  • WPDiscon - Phase Discontinuity
  • WPESquality - Perceptual Evaluation of Speech Quality measurement
  • WPPAnalysis - PRACH Preamble Analysis ( lab application only )
  • WSEMask - Spectrum Emission Mask measurement
  • WTDPower - TX Dynamic Power measurement
  • WTPower - Thermal Power measurement
  • WWQuality - Waveform Quality measurement

This command also queries the active state using the ON? keyword in place of a measurement mnemonic.

The INITiate command is associated with the SETup 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).

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

Requirements

Test Application Revision A.01 and above.

Test Application Revision A.02 added WCDomain, WSEMask, and WOBWidth.

Test Application Revision A.03 added WIQTuning, WILPower, WOOPower, and SMONitor.

Test Application Revision A.05 added WBLerror, WDPAnalysis and WPDiscon.

Test Application Revision A.06 added FSTability

Test Application Revision A.07 added WTDPower

Test Application Revision A.08 with the required feature license, added HBLerror

Test Application Revision A.09 with the required feature license, added CFDTune

Lab Application Revision: A.01 and above.

Lab Application Revision B.01 added WBLerror, WDPAnalysis, WPDiscon, and WPPAnalysis.

Lab Application Revision C.01 added FSTability, WCTFormat and WOOSynch

Lab Application Revision C.02 added WTDPower

Lab Application Revision C.03 added HBLerror

Lab Application Revision C.04 and D.00.04 added CFDTune

Test Application Revision A.10 and Lab Application Revision D.01 and above, added WEDPower

Lab Application Revision E.00.16 added HRCQuality

Lab Application Revision F.00.19 added EVMQpsk

Lab Application Revision G.00 added WPESquality

Programming Example

 
OUTPUT 714;"INITiate:WCPower;WWQuality:ON"
! Initiates a channel power and a waveform quality measurement.

INITiate:ON?

Function

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

Query

Range: AFAN|CFDT#|EVMQ*|FST|HBL#|HRCQ*|SAUD|SMON|WACL|WBER|WBL|WCD|WCP
|WCTF*|WDPA|WEDP|WILP|WIQT|WOBW|WOOP|WOOS*|WPD|WPES*|WPPA*
|WSEM|WTDP|WTP|WWQ|NONE

# Only applicable to the lab application or feature-licensed test application.

* Only applicable to the lab application.

Requirements

Test Application Revision A.01 and above.

Test Application Revision A.02 added WCDomain, WSEMask, and WOBWidth.

Test Application Revision A.03 added WIQTuning, WILPower, WOOPower, and SMONitor.

Test Application Revision A.05 added WBLerror, WDPAnalysis and WPDiscon.

Test Application Revision A.06 added FSTability

Test Application Revision A.07 added WTDPower

Test Application Revision A.08 with the required feature license, added HBLerror

Test Application Revision A.09 with the required feature license, added CFDTune

Lab Application Revision: A.01 and above.

Lab Application Revision B.01 added WBLerror, WDPAnalysis, WPDiscon, and WPPAnalysis.

Lab Application Revision C.01 added FSTability, WCTFormat and WOOSynch

Lab Application Revision C.02 added WTDPower

Lab Application Revision C.03 added HBLerror

Lab Application Revision C.04 and D.00.04 added CFDTune

Test Application Revision A.10 and Lab Application Revision D.01, added WEDPower

Lab Application Revision E.00.16 added HRCQuality

Lab Application Revision F.00.19 added EVMQpsk

Lab Application Revision G.00 added WPESquality

Programming Example

 
OUTPUT 714;"INITiate:ON?"

INITiate:CFDTune:ARMed?

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.09 and above, with the required feature license.
Lab Application Revision: C.04 or D.00.04 and above.

Programming Example

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

INITiate:<measurement mnemonic>:OFF

Function

Deactivates the selected measurement. See Measurement States .

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

Requirements

Test Application Revision A.01 and above.

Test Application Revision A.02 added WCDomain, WSEMask, and WOBWidth.

Test Application Revision A.03 added WIQTuning, WILPower, WOOPower, and SMONitor.

Test Application Revision A.05 added WBLerror, WDPAnalysis and WPDiscon.

Test Application Revision A.06 added FSTability

Test Application Revision A.07 added WTDPower

Test Application Revision A.08 with the required feature license, added HBLerror

Test Application Revision A.09 with the required feature license, added CFDTune

Lab Application Revision: A.01 and above.

Lab Application Revision B.01 added WBLerror, WDPAnalysis, WPDiscon, and WPPAnalysis.

Lab Application Revision C.01 added FSTability, WCTFormat and WOOSynch

Lab Application Revision C.02 added WTDPower

Lab Application Revision C.03 added HBLerror

Lab Application Revision C.04 and D.00.04 added CFDTune

Test Application Revision A.10 and Lab Application Revision D.01, added WEDPower

Lab Application Revision E.00.16 added HRCQuality

Lab Application Revision F.00.19 added EVMQpsk

Lab Application Revision G.00 added WPESquality

Programming Example

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

INITiate:COUNt?

Function

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

Query

Range: 0 to the number of measurements available in the application

Requirements

Test or Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"INITiate:COUNt?"

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|CFDT#|EVMQ*|FST|HBL#|HRCQ*|SAUD|SMON|WACL|WBER|WBL|WCD|WCP
|WCTF*|WDPA|WEDP|WILP|WIQT|WOBW|WOOP|WOOS*|WPD|WPES*|WPPA*|WSEM
|WTDP|WTP|WWQ|NONE

# Only applicable to the lab application or feature-licensed test application.

* Only applicable to the lab application.

Requirements

Test Application Revision A.01 and above.

Test Application Revision A.02 added WCDomain, WSEMask, and WOBWidth.

Test Application Revision A.03 added WIQTuning, WILPower, WOOPower, and SMONitor.

Test Application Revision A.05 added WBLerror, WDPAnalysis and WPDiscon.

Test Application Revision A.06 added FSTability

Test Application Revision A.07 added WTDPower

Test Application Revision A.08 with the required feature license, added HBLerror

Test Application Revision A.09 with the required feature license, added CFDTune

Lab Application Revision: A.01 and above.

Lab Application Revision B.01 added WBLerror, WDPAnalysis, WPDiscon, and WPPAnalysis.

Lab Application Revision C.01 added FSTability, WCTFormat and WOOSynch

Lab Application Revision C.02 added WTDPower

Lab Application Revision C.03 added HBLerror

Lab Application Revision C.04 and D.00.04 added CFDTune

Test Application Revision A.10 and Lab Application Revision D.01, added WEDPower

Lab Application Revision E.00.16 added HRCQuality

Lab Application Revision F.00.19 added EVMQpsk

INITiate:DONE:CLEar

Function

Clears the done flag from all measurements.

Requirements

Test or Lab Application Revision A.01 and above.

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

Requirements

Test Application or Lab Application Revision A.01 and above.

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 INITitate:DONE? query is sent.

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

Requirements

Test Application Revision A.01 and above.

Test Application Revision A.02 added WCDomain, WSEMask, and WOBWidth.

Test Application Revision A.03 added WIQTuning, WILPower, WOOPower, and SMONitor.

Test Application Revision A.05 added WBLerror, WDPAnalysis and WPDiscon.

Test Application Revision A.06 added FSTability

Test Application Revision A.07 added WTDPower

Test Application Revision A.08 with the required feature license, added HBLerror

Test Application Revision A.09 with the required feature license, added CFDTune

Lab Application Revision: A.01 and above.

Lab Application Revision B.01 added WBLerror, WDPAnalysis, WPDiscon, and WPPAnalysis.

Lab Application Revision C.01 added FSTability, WCTFormat and WOOSynch

Lab Application Revision C.02 added WTDPower

Lab Application Revision C.03 added HBLerror

Lab Application Revision C.04 and D.00.04 added CFDTune

Test Application Revision A.10 and Lab Application Revision D.01, added WEDPower

Lab Application Revision E.00.16 added HRCQuality

Lab Application Revision F.00.19 added EVMQpsk

Lab Application Revision G.00 added WPESquality

Programming Example

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

INITiate:WEDPower:ARMed?

Function

Queries the arm state of the extended range dynamic power measurement.

  • This command immediately returns a 1 if the extended range dynamic power measurement has been initiated and is ready to be triggered.
  • This command hangs if the extended range dynamic power 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 extended range dynamic power is not in the process of preparing for a trigger (for example, if the extended range dynamic power measurement has not been initiated, has been aborted, or has already been triggered).

Query

Range: 0 | 1

Requirement

Lab Application Revision: F.00 and above.

Programming Example

 
OUTPUT 714;"INITiate:WEDPower:ARMed?"
!Queries whether the test set's hardware is successfully
!set up for the extended range dynamic power measurement.