SETup:ORFSpectrum Common Parameters

Last Updated: August 29, 2007

These commands apply to all measurements in the Output RF Spectrum (ORFS) measurement suite.

For more information on the conventions used in the programming examples click here.

SETup:ORFSpectrum:CONTinuous[?]

Sets/queries the trigger state for the Output RF Spectrum measurement suite. See Triggering of Measurements.

Setting Range: Single trigger mode = 0 | OFF, Continuous trigger mode = 1 | ON

Query Range: 0 | 1

*RST Setting: 0 | OFF

Test Set Requirements: E6601A WCTS Program Version A.02 and above

Example:

' Specify single trigger mode for the Output RF Spectrum measurement suite.

TestSet.WriteString("SETup:ORFSpectrum:CONTinuous OFF")

SETup:ORFSpectrum:INITiate[?]

Sets/queries the measurements to enable for the Output RF Spectrum measurement suite.

After you perform a full preset of the test set, switch applications, or restart the test set, you must either send this command or the INITiate:ORFSpectrum[:ON] command, with one or more parameters specifying the measurements you want the Output RF Spectrum measurement suite to perform. Otherwise, if you attempt to use the INITiate:ORFSpectrum[:ON] command without specifying any parameters, the following error message is reported:

“Operation rejection; Sub-measurements must be enabled using ‘SETup:ORFSpectrum:INITiate <args>’ or ‘INITiate:ORFSpectrum[:ON] <args>’ before ‘INITiate:ORFSpectrum[:ON] can be accepted.”

Specifying a value of NONE disables all measurements in the suite.

If this command or the INITiate:ORFSpectrum[:ON] command has not enabled measurements in the suite since a power up, preset, or an application switch, the query form of this command returns a value of UNKN (short for UNKNown). This value indicates that you have not explicitly set up the measurements to enable for the Output RF Spectrum measurement suite, so it is indeterminate which sub-measurements are enabled.

Setting Range: One or more of the following values, separated by commas:

Query Range: One or more of the following values, separated by commas:

*RST Setting: UNKN

Test Set Requirements: E6601A WCTS Program Version A.02 and above

Example:

' Set the Output RF Spectrum suite to include only the ORFS modulation sub-measurement.

TestSet.WriteString("SETup:ORFSpectrum:INITiate MOD")

SETup:ORFSpectrum:INITiate:COUNt?

Queries the number of measurements enabled for the Output RF Spectrum measurement suite.

Setting Range: 1 to 2

Query Range: 1 to 2

Test Set Requirements: E6601A WCTS Program Version A.02 and above

Example:

' Query the number of sub-measurements enabled for the Output RF Spectrum measurement suite.

TestSet.WriteString("SETup:ORFSpectrum:INITiate:COUNt?")

SETup:ORFSpectrum:LIMit:CUSTom([1]|2):ETSI[:PRESet]

Sets the specified ORFS custom mask to the ETSI values for the current band and expected power.

Test Set Requirements: E6601A WCTS Program Version A.02 and above; A.04 added CUSTom1 (previously it was CUSTom) and CUSTom2

Example:

' Set the limit source to Custom for the Output RF Spectrum measurement suite.

TestSet.WriteString("SETup:ORFSpectrum:LIMit:CUSTom:ETSI")

SETup:ORFSpectrum:LIMit:SOURce[?]

Sets/queries whether the ORFS measurement suite uses the ETSI defined limits, user-defined limits you have specified, or no limit mask.

Setting Range: ETSI | CUSTom[1] | CUSTom2 | NOMask

Query Range: ETSI | CUST | CUST2 | NOM

*RST Setting: ETSI

Test Set Requirements: E6601A WCTS Program Version A.02 and above; A.04 added CUSTom1 (previously it was CUSTom) and CUSTom2

Example:

' Set the limit source to Custom for the Output RF Spectrum measurement suite.

TestSet.WriteString("SETup:ORFSpectrum:LIMit:SOURce CUSTom")

SETup:ORFSpectrum:TIMeout[:STIMe][?]

The setting form of this command performs two functions: (1) sets the measurement timeout value in seconds for the Output RF Spectrum measurement suite (see SETup:ORFSpectrum:TIMeout:TIME[?]) and (2) sets the measurement timeout state to on (see SETup:ORFSpectrum:TIMeout:STATe[?]).

The query form of this command returns the current Output RF Spectrum measurement suite timeout value.

The units (S|MS) are optional, if no units are specified then units default to S.

Setting Range: 0.1 to 999.9 s

Query Range: 0.1 to 999.9 s

Resolution: 0.01 s

*RST Setting: 10 s

Test Set Requirements: E6601A WCTS Program Version A.02 and above

Example:

' Set the measurement suite timeout to 20 seconds and set the timeout state to on.

TestSet.WriteString("SETup:ORFSpectrum:TIMeout 20S")

SETup:ORFSpectrum:TIMeout:STATe[?]

Sets/queries the measurement timeout state for the Output RF Spectrum measurement suite.

The measurement timeout state can also be set to on using the SETup:ORFSpectrum:TIMeout[:STIMe][?] command.

Setting Range: 0 | OFF | 1 | ON

Query Range: 0 | 1

*RST Setting: 0 | OFF

Test Set Requirements: E6601A WCTS Program Version A.02 and above

Example:

' Turn the measurement suite timeout state to on.

TestSet.WriteString("SETup:ORFSpectrum:TIMeout:STATe ON")

SETup:ORFSpectrum:TIMeout:TIME[?]

Sets/queries the measurement timeout value in seconds for the Output RF Spectrum measurement suite. The units (S|MS) are optional, if no units are specified then units default to S.

The measurement timeout value can also be set using the SETup:ORFSpectrum:TIMeout[:STIMe][?] command.

Setting Range: 0.1 to 999.9 s

Query Range: 0.1 to 999.9 s

Resolution: 0.01 s

*RST Setting: 10 s

Test Set Requirements: E6601A WCTS Program Version A.02 and above

Example:

' Set the measurement suite timeout to 20 seconds.

TestSet.WriteString("SETup:ORFSpectrum:TIMeout:TIME 20S")

SETup:ORFSpectrum:TRIGger:DELay[?]

Sets/queries the trigger delay in seconds for the Output RF Spectrum measurement suite. The units (S|MS|US|NS) are optional, if no units are specified then units default to S. See Triggering of Measurements.

Setting Range: -2.31 ms to +2.31 ms

Query Range: -2.31 ms to +2.31 ms

Resolution: 5 significant digits or 100 ns, whichever is greater

*RST Setting: 0 seconds

Test Set Requirements: E6601A WCTS Program Version A.02 and above

Example:

' Set trigger delay time to 1.5 milliseconds.

TestSet.WriteString("SETup:ORFSpectrum:TRIGger:DELay 1.5MS")

SETup:ORFSpectrum:TRIGger:SOURce[?]

Sets/queries the trigger source for the Output RF Spectrum measurement suite. See Triggering of Measurements.

Setting Range: ARB | EXTernal | IMMediate | RISE

Query Range: ARB | EXT | IMM | RISE

*RST Setting: RISE

Test Set Requirements: E6601A WCTS Program Version A.02 and above; A.04 added ARB

Example:

' Set the measurement suite trigger source to Rise.

TestSet.WriteString("SETup:ORFSpectrum:TRIGger:SOURce RISE")