Last Updated: August 29, 2007
These commands perform functions that control the test set's RF generator (measuring source).
For more information on the conventions used in the programming examples click here.
Deletes the specified set of arbitrary waveform (ARB) files from the ARB random access memory (RAM) disk directory.
All three files of the set are deleted (the waveform, the header and the marker files). Note that header and/or marker files may or may not exist for a given waveform file set.
Setting Range: List of loaded ARB files.
Query Range: List of loaded ARB files.
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Delete the set of ARB files for the ARB file set titled "waveform1".
TestSet.WriteString("RFGenerator:AWAVeform:DELete 'waveform1'")
Loads the specified arbitrary waveform (ARB) file. The file is loaded from the ARB hard disk directory to the ARB random access memory (RAM) disk directory.
Setting Range: List of loaded ARB files.
Query Range: List of loaded ARB files.
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Load the ARB file titled "waveform1".
TestSet.WriteString("RFGenerator:AWAVeform:LOAD 'waveform1'")
Sets/queries the ARB run mode. Setting this command to:
STARt starts running the ARB file from the beginning.
STOP provides no output and turns the TSP IF off.
Setting Range: STARt | STOP
Query Range: STAR | STOP
*RST Setting: STARt
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the ARB run mode to Stop.
TestSet.WriteString("RFGenerator:AWAVeform:RUN STOP")
Selects the specified arbitrary waveform (ARB) file from the ARB random access memory (RAM) disk directory.
For more information refer to Waveform File.
Setting Range: List of loaded ARB files.
Query Range: List of loaded ARB files.
*RST Setting: None
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Select the ARB file "waveform1" from the ARB RAM disk directory.
TestSet.WriteString("RFGenerator:AWAVeform:SELection 'waveform1'")
Sets/queries the external ARB trigger output setting. The external trigger drives the rear panel BBP TRIG OUT BNC connector. Available settings for this parameter include OFF (external triggering is off), and DLFRame (Downlink Frame trigger). See Triggering of Measurements.
Setting Range: OFF | DLFRame
Query Range: OFF | DLFR
*RST Setting: OFF
Test Set Requirements: E6601A WCTS Program Version A.03 and above
Example:
' Set the external ARB trigger output to downlink frame trigger.
TestSet.WriteString("RFGenerator:AWAVeform:TRIGger:EXTernal DLFRame")
Sets/queries the RF generator frequency control mode, either automatic (AUTO ON) or manual (AUTO OFF). When set to manual (AUTO OFF), you can specify the RF generator frequency using the RFGenerator:FREQuency[:SELected][?] command.
The optional [:SELected] keyword in this command specifies that the RF generator frequency control mode being set or queried applies to the currently selected application.
Setting Range: 0 | OFF | 1 | ON
Query Range: 0 | 1
*RST Setting: 1 | ON
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the RF generator frequency control mode to manual.
TestSet.WriteString("RFGenerator:CONTrol:FREQuency:AUTO OFF")
Sets/queries the RF generator frequency.
The units (GHZ|MHZ|KHZ|HZ) are optional, if no units are specified than units default to Hz.
The optional [:SELected] keyword in this command specifies that the RF generator frequency being set or queried applies to the currently selected application.
Setting Range: 380 to 2700 MHz
Query Range: 380 to 2700 MHz
Resolution: 1 Hz
*RST Setting: 800 MHz
Test Set Requirements: E6601A WCTS Program Version A.02 and above; A.05 changed lower frequency limit from 400 MHz to 380MHz
Example:
' Set the frequency of the RF Generator to 500 MHz.
TestSet.WriteString("RFGenerator:FREQuency 500MHZ")
Sets/queries the manual RF generator frequency. This command also sets the RF generator frequency control mode to manual (see RFGenerator:CONTrol:FREQuency:AUTO[:SELected][?]).
The units (GHZ|MHZ|KHZ|HZ) are optional, if no units are specified than units default to Hz.
The optional [:SELected] keyword in this command specifies that the RF generator frequency being set or queried applies to the currently selected application.
Setting Range: 380 to 2700 MHz
Query Range: 380 to 2700 MHz
Resolution: 1 Hz
*RST Setting: 800 MHz
Test Set Requirements: E6601A WCTS Program Version A.02 and above; A.05 changed lower frequency limit from 400 MHz to 380MHz
Example:
' Turn the RF generator frequency control to manual and set the frequency to 900 MHz.
TestSet.WriteString("RFGenerator:MFRequency 900MHZ")
Sets/queries the RF generator (source) modulation mode. The following selections are available:
Amplitude modulation (AM)
Arbitrary waveform generator (ARB)
Continuous wave (CW)
Double sideband suppressed carrier (DSBScarrier)
Frequency modulation (FM)
The optional [:SELected] keyword in this command specifies that the RF generator modulation mode being set or queried applies to the currently selected application.
Setting Range: AM | ARB | CW | DSBScarrier | FM
Query Range: AM | ARB | CW | DSBS | FM
*RST Setting: CW
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the modulation mode to amplitude modulation (AM).
TestSet.WriteString("RFGenerator:MODulation AM")
Sets/queries the RF generator (source) AM depth. This setting only applies when the modulation mode is set to AM (see RFGenerator:MODulation[:SELected][?]).
The optional [:SELected] keyword in this command specifies that the RF generator AM depth being set or queried applies to the currently selected application.
Setting Range: 0 to 99.9 %
Query Range: 0 to 99.9 %
Resolution: 0.1 %
*RST Setting: 30 %
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the AM depth to 40.0 %.
TestSet.WriteString("RFGenerator:AM:DEPTh 40")
Sets/queries the RF generator (source) FM deviation. This setting only applies when the modulation mode is set to FM (see RFGenerator:MODulation[:SELected][?]).
The optional [:SELected] keyword specifies that the setting or query applies to the currently selected application.
Setting Range: 0 kHz to 100 kHz
Query Range: 0 kHz to 100 kHz
Resolution: 0.001 kHz
*RST Setting: 5 kHz
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the FM deviation to 10 kHz.
TestSet.WriteString("RFGenerator:MODulation:FM:DEViation 10KHZ")
Sets/queries the RF generator (source) modulation frequency. This setting only applies when the modulation mode is set to AM, DSBScarrier, or FM (see RFGenerator:MODulation[:SELected][?]).
The optional [:SELected] keyword in this command specifies that the RF generator modulation frequency being set or queried applies to the currently selected application.
Setting Range: 0.1 kHz to 100 kHz
Query Range: 0.1 kHz to 100 kHz
Resolution: 0.001 kHz
*RST Setting: 1 kHz
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the modulation frequency of the source to 50 kHz.
TestSet.WriteString("RFGenerator:MODulation:FREQuency 50KHZ")
Sets/queries the RF Generator output destination. The destination is the front panel connector to which the RF Generator signal will be directed: RF IN/OUT (IO) or RF OUT ONLY (OUT).
Setting Range: IO | OUT
Query Range: IO | OUT
*RST Setting: IO
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the RF generator's output destination to the RF OUT ONLY port.
TestSet.WriteString("RFGenerator:OUTPut OUT")
The setting form of this command performs two functions: (1) sets the RF generator (source) power level (see RFGenerator:POWer:AMPLitude[:SELected][?]) and (2) sets the RF generator power state to on (see RFGenerator:POWer:STATe[:SELected][?]).
The query form of these commands return the RF generator (source) power level.
The optional [:SELected] keyword specifies that the setting or query applies to the currently selected application. The setting and query ranges may differ for other applications.
Setting Range: Depends on the output port:
RF IN/OUT: +45 to -170 dBm (-15 to -120 dBm actual hardware range with Amplitude Offset equal to 0 dB)
RF OUT ONLY: +45 to -170 dBm (-5 to -120 dBm actual hardware range with Amplitude Offset equal to 0 dB)
Query Range: Depends on the output port:
RF IN/OUT: +45 to -170 dBm
RF OUT ONLY: +45 to -170 dBm
Resolution: 0.01 dB
*RST Setting: -85 dBm
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the RF generator power level to -110 dBm and turn the state to On.
TestSet.WriteString("RFGenerator:POWer -110DBM")
Sets/queries the RF generator (source) power level.
The RF generator (source) power level can also be set using the RFGenerator:POWer[:SAMPLitude][:SELected][?] command.
The optional [:SELected] keyword specifies that the setting or query applies to the currently selected application. The setting and query ranges may differ for other applications.
Setting Range: Depends on the output port:
RF IN/OUT: +45 to -170 dBm (-15 to -120 dBm actual hardware range with Amplitude Offset equal to 0 dB)
RF OUT ONLY: +45 to -170 dBm (-5 to -120 dBm actual hardware range with Amplitude Offset equal to 0 dB)
Query Range: Depends on the output port:
RF IN/OUT: +45 to -170 dBm
RF OUT ONLY: +45 to -170 dBm
Resolution: 0.01 dB
*RST Setting: -85 dBm
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the RF generator power level to -110 dBm.
TestSet.WriteString("RFGenerator:POWer:AMPLitude -110DBM")
Sets/queries the RF generator (source) state.
The RF generator (source) state can also be set to on using the RFGenerator:POWer[:SAMPLitude][:SELected][?] command.
Setting Range: 0 | OFF | 1 | ON
Query Range: 0 | 1
*RST Setting: 1 | ON
Test Set Requirements: E6601A WCTS Program Version A.02 and above
Example:
' Set the RF generator state to Off.
TestSet.WriteString("RFGenerator:POWer:AMPLitude:STATe OFF")
Returns a "1" only when the RF generator has settled according to the specified parameters (RFGenerator:SETTled:FREQuency[?], RFGenerator:SETTled:LEVel[?]). This feature is only available remotely.
Query Range: 1
Test Set Requirements: E6601A WCTS Program Version A.03 and above
Example:
' Return a 1 only when the RF generator (source) has settled.
TestSet.WriteString("RFGenerator:SETTled?")
Sets/queries the RF generator settling target frequency. This feature is only available remotely.
Setting Range: THZ1 | HZ1 | HZ10 | HZ100 (0.1 Hz|1.0 Hz|10.0 Hz|100 Hz respectively)
Query Range: THZ1 | HZ1 | HZ10 | HZ100
*RST Setting: HZ100
Test Set Requirements: E6601A WCTS Program Version A.03 and above
Example:
' Set the RF generator settling target level to 10 Hz.
TestSet.WriteString("RFGenerator:SETTled:FREQuency HZ10")
Sets/queries the RF generator settling target level. This feature is only available remotely.
Setting Range: HDB1 | HDB2 | HDB5 | TDB1 (0.01 dB|0.02 dB|0.05 dB|0.1 dB respectively)
Query Range: HDB1 | HDB2 | HDB5 | TDB1
*RST Setting: HDB1
Test Set Requirements: E6601A WCTS Program Version A.03 and above
Example:
' Set the RF generator settling target level to 0.02 dB.
TestSet.WriteString("RFGenerator:SETTled:LEVel HDB2")