INITiate

INITiate

Last updated: January 18, 2010

GPIB Command Conventions

INITiate:<measurement mnemonic>[:ON]

Function

GSM TA

Starts measurements with the test set.

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

One or more measurements may be initiated on the same program line. See Concurrent Measurements .

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

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements GSM/GPRS/
EGPRS TA

Revision: A.01 and above

GSM/GPRS/ EGPRS LA

Revision: C.01 and above

Programming Example

 
OUTPUT 714;"INITIATE:TXPOWER:ON" !Initiates a TX Power measurement.
 
OUTPUT 714;"INITIATE:TXPOWER;PFERROR:ON" 
! Initiates TX Power and phase and frequency error measurements.
 
OUTPUT 714;"INITIATE:PVTIME;ORFSPECTRUM;FBERROR:ON" 
! Initiates power versus time output RF spectrum, and fast bit error rate measurements.

INITiate:<measurement mnemonic>:OFF

Function

GSM TA

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, see ABORt .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements GSM/GPRS/
EGPRS TA

Revision: A.01 and above

GSM/GPRS/ EGPRS LA

Revision: C.01 and above

Programming Example

 
OUTPUT 714;"INITIATE:TXPOWER:OFF" 
! Deactivates TX power measurement.

INITiate:COUNt?

Function

GSM TA

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

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Query

Range: 0 to 10

Resolution: 1

Note: Some measurements are mutually exclusive, and so cannot be run at the same time as others, and some measurement close all other measurements. See Concurrent Measurements .

Requirements GSM/GPRS/
EGPRS TA

Revision: A.01 and above

GSM/GPRS/ EGPRS LA

Revision: C.01 and above

INITiate:DONE?

Function

GSM TA

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

See Measurement Event Synchronization for details on 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.

Note that WAIT is returned when no measurements are done. NONE is returned when all measurements are done.

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Query

GSM TA

Range:

NONE|AAUD|BERR|DAUD|DPOW|FBER|FST|IQT|MTA|ORFS|PCAL |PFER|PVT| SMON| TXP|WAIT

GPRS TA

Range:

NONE|BLER|DPOW|FST|GBER|IQT|ORFS|PCAL |PFER|PVT| SMON| TXP|WAIT

EGPRS TA

Range:

NONE|BLER|DPOW|EDP|EMAC|ETXP|FST|GBER|IQT|ORFS|PCAL| PFER|PVT| SBER|SMON| TXP|WAIT

GSM/GPRS LA

Range:

NONE|AAUD|BERR|BFI|BLER|DAUD|DPOW|FBER|FFER|FST|GBER|GPES| IQT|MTA|ORFS|PCAL| PFER|PVT|SFER|SMON| TXP|WAIT|IFER

EGPRS LA

Range:

NONE|AAUD|BERR|BFI|BLER|DAUD|DPOW|EDP|EMAC|ETXP|FBER|FFER|FST|GBER|GPES|IQT|MTA|ORFS|PCAL| PFER|PVT|SBER|SFER| SMON| TXP|WAIT|IFER

Requirements GSM/GPRS/
EGPRS TA

Revision: A.01 and above
Revision A.03 adds SBER
Revision A.04 adds EDP and FST
Revision A.06 with the required feature license adds PCAL

GSM/GPRS/ EGPRS LA

Revision: C.01 and above
Revision C.03 adds BFI, FFER, and SBER
Revision D.01 adds EDP, FST and IFER
Revision D.03 adds PCAL
Revision F.00.37 adds SFER
Revision H.00.xx adds GPES

INITiate:DONE:CLEar

Function

GSM TA

Clears the done flag from all measurements. See INITiate:DONE? .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Requirements GSM/GPRS/
EGPRS TA

Revision: A.01 and above

GSM/GPRS/ EGPRS LA

Revision: C.01 and above

Programming Example

 
OUTPUT 714;"INITIATE:DONE:CLEAR" 
! Clears done flag.

INITiate:DONE:FLAG[:ALL]

Function

GSM TA

Specifies that all measurements are considered, (included or excluded) when the DONE? query is sent.

If a measurements trigger arm, see Trigger Arm (Single or Continuous) Description , has been left in continuous mode, the done flag for that measurement will toggle between DONE and WAIT, see INITiate:DONE? . 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 trigger arm must be left in continuous mode the user should (exclude) it, using this command, from the INITiate:DONE? query results.

Once the INITiate:DONE:FLAG has been set to EXCLude for a measurement, you must send the INCLude command for that measurement in order to query that measurement with, the INITiate:DONE? query. The test set will reset an (excluded measurement) to be an (included measurement) at power on or with any form of preset, see Preset Descriptions .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Setting

Range

  • INCLude: include all measurements

  • EXCLude: exclude all measurements

Requirements GSM/GPRS/
EGPRS TA

Revision: A.01 and above

GSM/GPRS/ EGPRS LA

Revision: C.01 and above

Programming Example

 
OUTPUT 714;"INITIATE:DONE:FLAG:ALL EXCLUDE" 
! Excludes all measurements from contributing the INITIATE:DONE? query, 
! see "INITiate:DONE?" on page 6.

INITiate:DONE:FLAG:<measurement mnemonic>

Function

GSM TA

Specifies which measurements are considered, (included or excluded) when the DONE? query is sent.

If a measurements trigger arm, see Trigger Arm (Single or Continuous) Description , has been left in continuous mode, the done flag for that measurement will toggle between DONE and WAIT, see INITiate:DONE? . The INITiate:DONE? query will 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 trigger arm must be left in continuous mode the user should (exclude) it, using this command, from the INITiate:DONE? query results.

Once the 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 reset any (excluded measurement) to be an (included measurement) at power on or with any form of preset, see Preset Descriptions .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Setting

GSM TA

Range

  • INCLude

    • :AAUDio | :BERRor | :DAUDio | :DPOWer | :FBERror | :IQTuning | :MTAudio|:ORFSpectrum | :PCALibration |:PFERror | :PVTime | :SMONitor | :TXPower
  • EXCLude

    • :AAUDio | :BERRor |:DAUDio | :DPOWer | :FBERror | :IQTuning | :MTAudio|:ORFSpectrum | :PCALibration |:PFERror | :PVTime | :SMONitor | :TXPower

GPRS TA

Range

  • INCLude

    • :BLERror | :DPOWer | :GBERror | :IQTuning | :ORFSpectrum | :PCALibration |:PFERror | :PVTime | :SMONitor | :TXPower
  • EXCLude

    • :BLERror | :DPOWer | :GBERror | :IQTuning | :ORFSpectrum | :PCALibration |:PFERror | :PVTime | :SMONitor | :TXPower

EGPRS TA

Range

  • INCLude

    • :BLERror | :DPOWer |:EDPower| :EMACcuracy | :ETXPower | :GBERror | :IQTuning | :ORFSpectrum |:PCALibration | :PFERror | :PVTime |:SBERror |:SMONitor | :TXPower
  • EXCLude

    • :BLERror | :DPOWer |:EDPower| :EMACcuracy | :ETXPower | :GBERror | :IQTuning | :ORFSpectrum | :PCALibration |:PFERror | :PVTime |:SBERror |:SMONitor | :TXPower

GSM/GPRS LA

Range

  • INCLude

    • :AAUDio | :BERRor | :BFINdication | :BFI | :BLERror | :DAUDio | :DPOWer | :FBERror | :FFERate | :GBERror |:GPES | :IQTuning | :MTAudio | :ORFSpectrum | :PCALibration |:PFERror | :PVTime | :SFERate | :SMONitor | :TXPower
  • EXCLude

    • :AAUDio | :BERRor | :BFINdication | :BFI | :BLERror | :DAUDio | :DPOWer | :FBERror | :FFERate | :GBERror |:GPES| :IQTuning | :MTAudio | :ORFSpectrum | :PCALibration | :PFERror | :PVTime | :SFERate | :SMONitor | :TXPower

EGPRS LA

Range

  • INCLude

    • :AAUDio | :BERRor | :BFINdication | :BFI | :BLERror | :DAUDio | :DPOWer |:EDPower| :EMACcuracy | :ETXPower | :FBERror | :FFERate | :GBERror |:GPES | :IQTuning | :MTAudio | :ORFSpectrum |:PCALibration | :PFERror | :PVTime | :SBERror | :SFERate | :SMONitor | :TXPower
  • EXCLude

    • :AAUDio | :BERRor | :BFINdication | :BFI | :BLERror | :DAUDio | :DPOWer |:EDPower| :EMACcuracy | :ETXPower | :FBERror | :FFERate | :GBERror |:GPES | :IQTuning | :MTAudio | :ORFSpectrum |:PCALibration | :PFERror | :PVTime | :SBERror | :SFERate | :SMONitor | :TXPower

Related Topics

INITiate:DONE?

Requirements GSM/GPRS/
EGPRS TA

Revision: A.01 and above
Revision A.03 adds SBERror
Revision A.04 adds EDPower
Revision A.06 with the required feature license adds PCALibration

GSM/GPRS/ EGPRS LA

Revision: C.01 and above
Revision C.03 adds BFINdication|BFI, FFERate, and SBERror
Revision D.01 adds EDPower and IFERror
Revision D.03 adds PCALibration
Revision F.00.37 adds SFERate
Revision H.00.xx adds GPES

Programming Example

 
OUTPUT 714;"INITIATE:DONE:FLAG:PFERROR EXCLUDE" 
! Excludes PFERROR measurements from contributing to the INITIATE:DONE? query.

INITiate:ON?

Function

GSM TA

Queries the names of the measurements (none, one, or more than one) that are ON in a comma separated list of measurement mnemonics. See INITiate:<measurement mnemonic>[:ON] .

GPRS TA

EGPRS TA

GSM/GPRS LA

EGPRS LA

Query

GSM TA

Range: AAUD|BERR|DAUD|DPOW|FBER|FFER|IQT|MTA|NONE|ORFS| PCAL |PFER|PVT|SMON|TXP

GPRS TA

Range:
BLER|DPOW|GBER|NONE|IQT|ORFS|PCAL|PFER |PVT|SMON|TXP

EGPRS TA

Range:
BLER|DPOW|EDP|EMAC|ETXP|GBER|NONE|IQT|ORFS|PCAL|PFER |PVT|SBER|SMON|TXP

GSM/GPRS LA

Range: AAUD|BERR|BFI|BLER|DAUD|DPOW|FBER|FFER|GBER|GPES|IQT|MTA| NONE| ORFS|PCAL|PFER|PVT|SMON|TXP

EGPRS LA

Range: AAUD|BERR|BFI|BLER|DAUD|DPOW|EDP|EMAC|ETXP|FBER|FFER|GBER|GPES| IQT| MTA|NONE|ORFS|PCAL|PFER|PVT|SBER|SMON|TXP

Requirements GSM/GPRS/
EGPRS TA

Revision: A.01 and above
Revision A.03 adds SBER
Revision A.04 adds EDP
Revision A.06 with the required feature license adds PCAL

GSM/GPRS/ EGPRS LA

Revision: C.01 and above
Revision C.03 adds BFI, FFER, and SBER
Revision D.01 adds EDP and IFER
Revision D.03 adds PCALibration
Revision H.00.xx adds GPES

INITiate:PCALibration:ARMed?

Function

GSM/GPRS TA

This command is not applicable to GSM TA.

EGPRS TA

This command is not applicable to GPRS TA.

GSM/GPRS LA

This command queries whether the hardware of the test set has been armed to accept PAvT Measurement. The GPIB bus will be hung untill the results is returned.

EGPRS TA

Query

Range: 0 | 1

*RST Setting

0|OFF

Requirements

GSM/GPRS/
EGPRS TA

Revision: A.10 and above

GSM/GPRS/
EGPRS LA

Revision: G.00.00 and above

INITiate:TXPower:BMEasure:ARMed?

Function

GSM TA

This command queries whether the hardware of the test set has been armed to accept input RF signal in the GPRS BCH+PDTCH or EGPRS BCH+PDTCH operating mode when the uplink burst configuration is set to ON. The GPIB bus will be hung until the results is returned.

GPRS TA

GSM/GPRS LA

EGPRS LA

EGPRS TA

Query

Range: 0 | 1

*RST Setting

0|OFF

Requirements

GSM/GPRS/
EGPRS TA

Revision: A.11 and above

GSM/GPRS/
EGPRS LA

Revision: G.01 and above

INITiate:TXPower:GFDTune:ARMed?

Function

GSM TA

This command queries whether the hardware of the test set has been armed to accept input RF signal in the Fast Device Tune operation mode. The GPIB bus will be hung until the results is returned.

GPRS TA

GSM/GPRS LA

EGPRS LA

EGPRS TA

Query

Range: 0 | 1

*RST Setting

0|OFF

Requirements

GSM/GPRS/
EGPRS TA

Revision: A.07 and above

GSM/GPRS/
EGPRS LA

Revision: E.01 and above