INITiate

Last updated: May 26, 2009

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

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\|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
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

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

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