Last Updated: August 29, 2007
These commands set parameters for the Output RF Spectrum (ORFS) Modulation measurement in the ORFS measurement suite.
SETup:ORFSpectrum:MODulation:ABSolute:LIMit:CUSTom([1]|2)[:MASK][?]
SETup:ORFSpectrum:MODulation:ABSolute:LIMit:CUSTom([1]|2):POINts?
SETup:ORFSpectrum:MODulation:RELative:LIMit:CUSTom([1]|2)[:MASK][?]
SETup:ORFSpectrum:MODulation:RELative:LIMit:CUSTom([1]|2):POINts?
For more information on the conventions used in the programming examples click here.
Sets/queries the absolute limits for the specified custom mask to be used with the ORFS Modulation measurement. This command allows you to define two custom masks by specifying CUSTom1 or CUSTom2. When a frequency offset is changed, the limit value is recalculated for the new frequency offset by interpolating the Custom Mask.
A total of 22 reference points (frequency point / limit value mask point pairs) are available to you when defining a custom mask. Any order of points can be specified, but the list is sorted before being applied to internal settings. The query returns the points in the sorted order. Frequency offsets that fall outside the Custom mask will always return a PASS result.
The custom mask is turned off when no points are specified in this command. Note that values must be entered in fundamental units.
Setting Range: 0 to 22 comma-separated value pairs (no units) containing frequency point and absolute power limit values within the following ranges:
Frequency: -1800 kHz to 1800 kHz
Absolute Limit Value: -200 dBm to 200 dBm
Query Range: 0 to 22 comma-separated value pairs containing frequency point and absolute power limit values within the following ranges:
Frequency: -1800 kHz to 1800 kHz and 9.91 E+37 (NAN) if no offsets are specified.
Absolute Limit Value: -200 dBm to 200 dBm
Resolution:
Frequency: 10 Hz
Absolute Limit Value: 0.01 dBm
*RST Setting: 9.91 E+37 (NAN) - no offsets specified
Test Set Requirements: E6601A WCTS Program Version A.02 and above; A.04 added CUSTom1 (previously it was CUSTom) and CUSTom2
Example:
' Turn off the ORFS modulation custom mask.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:ABSolute:LIMit:CUSTom")
Queries the number of enabled reference points for the specified ORFS Modulation absolute custom mask.
Setting Range: 0 to 22
Query Range: 0 to 22
Resolution: 1
*RST Setting: 0
Test Set Requirements: E6601A WCTS Program Version A.02 and above; A.04 added CUSTom1 (previously it was CUSTom) and CUSTom2
Example:
' Query the number of enabled reference points for the ORFS Modulation Absolute custom mask.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:ABSolute:LIMit:CUSTom:POINts?")
Sets/queries which uplink burst will be measured for the ORFS Modulation measurement when the RFANalyzer:BURSt[:UPLink][?] command is set to a value greater than 1.
This setting has no effect on GSM calls; the measurement burst will always be 1.
Setting Range: 1 | 2
Query Range: 1 | 2
Resolution: 1
*RST Setting: 1
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Specify that the ORFS measurement should be made on burst 2 in the multislot configuration.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:BURSt 2")
Sets/queries the number of averages for the ORFS Modulation measurement and for the 30 kHz reference power.
Note that if the SETup:ORFSpectrum:MODulation:FAST[?] command is set to On, then half as many bursts are required because two measurements are made per burst.
Setting Range: 1 to 999
Query Range: 1 to 999
Resolution: 1
*RST Setting: 20
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Sets/queries the number of averages for ORFS modulation and the 30 kHz reference power to 50.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:COUNt 50")
The setting form of this command performs two functions: (1) sets the ETSI conversion factor for the ORFS Modulation measurement (see SETup:ORFSpectrum:MODulation:ETSI:CFACtor:VALue[?]) and (2) sets the ETSI conversion factor state to on (see SETup:ORFSpectrum:MODulation:ETSI:CFACtor:STATe[?]).
The query form of this command returns the current ETSI conversion factor value.
Setting Range: -20 dB to 0 dB
Query Range: -20 dB to 0 dB
Resolution: 0.01 dB
*RST Setting: Not applicable as the ETSI conversion factor *RST setting is OFF
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the ETSI conversion factor to -10 dB and turn the state to On.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:ETSI:CFACtor -10DB")
Sets/queries the ETSI conversion factor value.
The ETSI conversion factor value can also be set using the SETup:ORFSpectrum:MODulation:ETSI:CFACtor[:SVALue][?] command.
Setting Range: -20 dB to 0 dB
Query Range: -20 dB to 0 dB
Resolution: 0.01 dB
*RST Setting: Not applicable as the ETSI conversion factor *RST setting is OFF
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the ETSI conversion factor to -9 dB
TestSet.WriteString("SETup:ORFSpectrum:MODulation:ETSI:CFACtor:VALue -9DB")
Sets/queries whether the ETSI conversion factor feature for the ORFS modulation measurement is on or off.
The ETSI conversion factor state can also be set to on using the SETup:ORFSpectrum:MODulation:ETSI:CFACtor[:SVALue][?] 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:
' Set the ETSI conversion factor state to On.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:ETSI:CFACtor:STATe 1")
Sets/queries the fast measurement state, which determines whether or not the ORFS due to modulation measurement is performed exactly as defined in the ETSI standards.
When set to On, the measurement is performed on both the front and back sections of the burst. With this setting, the test set can provide two modulation measurements per burst, effectively doubling measurement throughput.
When set to Off, the measurement is only performed on the latter section of the burst as defined in the ETSI GSM standards.
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:
' Sets the ORFS modulation measurement to be performed exactly as defined in the ETSI standards.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:FAST OFF")
Sets/queries the list of ORFS Modulation frequency offsets. Each offset listed in the command is turned on by default. If no frequency offsets (null list) are sent, the ORFS Modulation measurement will not be made. The units (GHZ|MHZ|KHZ|HZ) are optional, if no units are specified than units default to HZ.
Setting Range: 0 to 22 comma-separated values ranging from -1800 to 1800 kHz
Query Range: 0 to 22 comma-separated values ranging from -1800 to 1800 kHz
Resolution: 10 Hz
*RST Setting:
Offset 1: 400.0 kHz
Offset 2: 600.0 kHz
Offsets 3 to 22: off
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Turn on the first two ORFS due to modulation measurement offsets and set
' them to 400 kHz and 700 kHz offsets. All other offsets are in the off state.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:FREQuency 400 KHZ, 700 KHZ")
Queries the number of frequency offsets currently on during an ORFS due to modulation measurement.
Query Range: 0 to 22
Resolution: 1
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Query the number of frequency offsets currently on during an ORFS due to modulation measurement.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:FREQuency:POINts?")
Sets/queries the relative limits for the specified custom mask to be used with the ORFS Modulation measurement. This command allows you to define two custom masks by specifying CUSTom1 or CUSTom2. When a frequency offset is changed, the limit value is recalculated for the new frequency offset by interpolating the Custom Mask.
A total of 22 reference points (frequency point / limit value mask point pairs) are available to you when defining a custom mask. Any order of points can be entered, but the list is sorted before being applied to internal settings. A query returns the points in the sorted order.
Frequency Offsets that fall outside the Custom Mask will always return a PASS result.
The custom mask is turned off when no points are specified in this command.
Note that values must be entered in fundamental units.
Setting Range: 0 to 22 comma-separated value pairs (no units) containing frequency point and limit value within the following ranges:
Frequency: -1800 kHz to 1800 kHz
Limit Value: -200 dB to 200 dB
Query Range: 0 to 22 comma-separated value pairs containing frequency point and limit value within the following ranges:
Frequency: -1800 kHz to 1800 kHz and 9.91E+37 (NAN) if no offsets are specified.
Limit Value: -200 dB to 200 dB
Resolution:
Frequency: 1 Hz
Limit Value: 0.01 dB
*RST Setting: 9.91 E+37 (NAN) - no offsets specified
Test Set Requirements: E6601A WCTS Program Version A.02 and above; A.04 added CUSTom1 (previously it was CUSTom) and CUSTom2
Example:
' Turn off the ORFS modulation custom mask.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:RELative:LIMit:CUSTom")
Queries the number of enabled reference points for the specified ORFS Modulation Relative custom mask.
Setting Range: 0 to 22
Query Range: 0 to 22
Resolution: 1
*RST Setting: 0
Test Set Requirements: E6601A WCTS Program Version A.02 and above; A.04 added CUSTom1 (previously it was CUSTom) and CUSTom2
Example:
' Query the number of enabled reference points for the ORFS Modulation Relative custom mask.
TestSet.WriteString("SETup:ORFSpectrum:MODulation:RELative:LIMit:CUSTom:POINts?")