This subsystem controls the frequency and power of the internal signal source, configures and starts the source power calibration, and provides output port settings.
Command tree: SOURce<Ch>
:FREQuency
:CONVersion
:ARBitrary
:MIXer
:POWer
:CORRection(source power calibration commands)
[:LEVel|
[:IMMediate]
:TDIF (commands for true differential mode)
Note: The SOURce<Ch>:POWer... subsystem comprises port-specific and general settings. Port-specific settings are valid for the port specified by the numeric suffix <Pt> (...:POWER<Pt>:...). General settings are valid for all test ports of the analyzer; the port suffix is ignored. Refer to the description of the individual commands for more information.
Defines the fixed (Continuous Wave, CW) frequency for all sweep types operating at fixed frequency (power sweep, time sweep, CW mode sweep). The two command forms SOUR:FREQ:CW and SOUR:FREQ:FIX are equivalent.
SOURce<Ch>:FREQuency<Pt>:CW|FIXed is equivalent to [SENSe<Ch>:]FREQuency:CW|FIXed. Source and receiver frequency are equal; the four commands overwrite each other. With option ZVA-K4, Frequency Conversion, independent offset frequencies can be defined for the source and receiver frequencies; see SOURce<Ch>:FREQuency<Pt>:CONVersion:ARBitrary:IFRequency and [SENSe<Ch>:]FREQuency:CONVersion:ARBitrary.
<Ch> |
Channel number. If unspecified the numeric suffix is set to 1.
|
<Pt> |
Test port number of the analyzer. This suffix is ignored because the selected frequency applies to all source ports used in the active channel.
|
<fixed_frequency> |
Fixed stimulus and analyzer frequency. |
Range [def. unit] |
Depending on the instrument model [Hz]. The increment (parameters UP or DOWN) is 0.1 kHz. |
*RST value |
1 GHz
|
SCPI, Command Types |
Confirmed, command or query
|
Example: |
Activate a power sweep and select the wave quantity
a1
Set the CW frequency to 100 MHz.
|
Defines the converter source frequency at the converter port <Pt>. This command is available for frequency converters with electronic attenuators R&S ZVA-ZxxxE. The converter source frequency is either a range (for frequency sweeps) or a CW frequency (for power, time and CW Mode sweeps). It is used as a reference during power calibration.
The frequency formula is applied even if the analyzer returns an error message, because the frequency is outside the allowed range.
<Ch> |
Channel number.
|
<Pt> |
Test port number of the analyzer.
|
<numerator> |
Parameters of the frequency formula. The
source frequency fs
is calculated according to The conversion formula for fs is ZVR-compatible but differs from manual control where the ratio <numerator>/<denominator> also multiplies the <offset>. In manual control, the <offset> is defined as a product of a ratio of two integers times a multiple of 1 Hz. |
Range [def. unit] |
For consistency the converter source frequency
or frequency range should be an integer multiple of the source frequency
at the analyzer port (SOURce<Ch>:FREQuency<Pt>:CONVersion:ARBitrary:IFRequency).
The multiplier must be equal to the selected harmonic order (<denominator>/<numerator>);
see example below. In addition the following restrictions apply: The selected converter source frequency must be within the nominal frequency range of the frequency converter, otherwise an error message "–222, Data out of range..." is generated. |
*RST value |
The default frequency/frequency range corresponds
to the frequency range or start frequency of the converter, i.e.
|
Sweep type Parameters |
SWEep –
A frequency sweep is active, the command defines a frequency range. |
*RST value |
SWEep
|
SCPI, Command Types |
Device-specific, command or query
|
Example: |
FREQ:CONV:DEV:NAME 'ZVA-Z110E' Select frequency converter type R&S ZVA-Z110E. FREQ:CONV:DEV:MODE RILI Select internal RF and source frequencies. FREQ:STAR 7.5E+10; :STOP 1E+11 Restrict the base frequency range to 75 GHz to 100 GHz. SOUR:FREQ1:CONV:ARB:IFR 1, 6, 5E+7, SWE Increase the RF source frequency at port 1 by 50 kHz. SOUR:FREQ1:CONV:ARB:CFR 1, 1, 3E+8, SWE Adjust the frequency axis of the converter output. SOUR:POW:CONV:OFFS 3, CPAD Increase the output power of the converter by +3 dB..
|
Defines an external generator frequency for frequency-converting measurements. The external generator frequency is either a range (for frequency sweeps) or a CW frequency (for power, time and CW Mode sweeps).
<Ch> |
Channel number.
|
<Pt> |
Test port number of the analyzer. This suffix is ignored because the generator is referenced via <Gen>.
|
<Gen> |
Generator number
|
<Boolean> |
Switch the generator on or off.
|
<numerator> |
Parameters of the frequency formula. The
source frequency fs
is calculated according to The conversion formula for fs is ZVR-compatible but differs from manual control where the ratio <numerator>/<denominator> also multiplies the <offset>. In manual control, the <offset> is defined as a product of a ratio of two integers times a multiple of 1 Hz. |
Range [def. unit] |
The converted frequency or frequency range
must be within the external generator's frequency range [Hz]. In addition
the following restrictions apply: |
*RST value |
The default frequency/frequency range corresponds
to the sweep range or CW frequency of the analyzer, i.e.
|
Sweep type Parameters |
SWEep –
A frequency sweep is active, the command defines a frequency range. |
*RST value |
SWEep
|
SCPI, Command Types |
Device-specific, command or query
|
Example: |
*RST; FREQ:STAR 1E+9; STOP 1.1E+9 Reset the analyzer (activating a frequency sweep) and set the sweep range between 1 GHz and 1.1 GHz. SYST:COMM:RDEV:GEN1:DEF 'Ext. Gen. 1', 'SME02', 'gpib0', '21' Configure an R&S SME02 generator as external generator no. 1, assigning the name Ext. Gen. 1 and a GPIB address 21. SOUR:FREQ:CONV:ARB:EFR ON, 1, 4, 1E+9, SWE Switch the generator on and convert the generator frequency to the range between 1.25 GHz and 1.275 GHz.
|
Defines the port-specific source frequency for frequency-converting measurements. The source frequency is either a range (for frequency sweeps) or a CW frequency (for power, time and CW Mode sweeps).
The frequency formula is applied even if the analyzer returns an error message, because the frequency is outside the allowed range.
<Ch> |
Channel number.
|
<Pt> |
Test port number of the analyzer. Note that the source frequencies at ports 1/2 and at ports 3/4 must be the same if the RF signal is simultaneously fed to two coupled ports.
|
<numerator> |
Parameters of the frequency formula. The
source frequency fs is calculated
according to The conversion formula for fs is ZVR-compatible but differs from manual control where the ratio <numerator>/<denominator> also multiplies the <offset>. In manual control, the <offset> is defined as a product of a ratio of two integers times a multiple of 1 Hz. |
Range [def. unit] |
The converted frequency or frequency range
must be within the analyzer's frequency range, depending on the instrument model
[Hz]. In addition the following restrictions apply: |
*RST value |
The default frequency/frequency range corresponds
to the sweep range or CW frequency of the analyzer, i.e.
|
Sweep type Parameters |
SWEep –
A frequency sweep is active, the command defines a frequency range. |
*RST value |
SWEep
|
SCPI, Command Types |
Device-specific, command or query
|
Example: |
*RST; FREQ:STAR 1E+9; STOP 1.1E+9 Reset the analyzer (activating a frequency sweep) and set the sweep range between 1 GHz and 1.1 GHz. SOUR:FREQ2:CONV:ARB:IFR 2, 1, 1E+9, SWE Convert the source frequency at test port no. 2 to the range between 3 GHz and 3.2 GHz.
|
Selects the mixer input signal which is at the fundamental power (channel power, to be defined by means of SOURce<Ch>:POWer<Pt>:STARt, SOURce<Ch>:POWer<Pt>:STOP, SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate][:AMPlitude]).
<Ch> |
Channel number.
|
<Pt> |
Physical port number of the analyzer. This suffix is ignored, because the port assignments for mixer measurement are fixed. |
Parameters |
RF –
mixer input signal |
*RST value |
RF
|
SCPI, Command Types |
Device-specific, command or query.
|
Example: |
See SOURce<Ch>:FREQuency:CONVersion:MIXer:PFIXed
|
Defines a fixed power for the Aux LO signal in a vector mixer measurement (option R&S ZVA-K5). The Aux LO signal is fed to the MEAS and REF mixers.
<Ch> |
Channel number.
|
<Pt> |
Physical port number of the analyzer. This suffix is ignored, because the port assignments for mixer measurement are fixed. |
<aux_fixed_power> |
Fixed power for Aux LO |
Range [def. unit] |
–40 dBm to +10 dBm. The exact range depends on the analyzer model or external generator used; refer to the data sheet [dBm]. UP and DOWN increment/decrement the source power in 0.1-dB steps. |
*RST value |
–25 dBm
|
SCPI, Command Types |
Device-specific, command or query.
|
Example: |
*RST; SOUR:FREQ:CONV:MIX:PAF –10 Reset the analyzer and specify a fixed Aux LO power of –10 dBm. SENS:FREQ:CONV:MIX:APOR 1 Select the test setup where the additional mixers MEAS and REF are connected to port 1 of the NWA. SENS:FREQ:CONV:MIX:AINT 3 Select the analyzer port 3 as a source port for the Aux LO signal. Alternatively, e.g. for a 2-port NWA in combination with an external generator: SYST:COMM:RDEV:GEN1:DEF 'Ext. Gen. 1', 'SME02', 'gpib0', '21' Configure an R&S SME02 generator as external generator no. 1, assigning the name Ext. Gen. 1 and a GPIB address 21. FREQ:CONV:MIX:AEXT 1 Select the generator no. 1 as a signal source for the Aux LO signal.
|
Defines a fixed power, to be assigned either to the RF or to the LO signal (the signal not addressed by SOURce<Ch>:]FREQuency:CONVersion:MIXer:FUDamental RF | LO).
<Ch> |
Channel number.
|
<Pt> |
Physical port number of the analyzer. This suffix is ignored, because the port assignments for mixer measurement are fixed. |
<fixed_power> |
Fixed power. |
Range [def. unit] |
–40 dBm to +10 dBm. The exact range depends on the analyzer model or external generator used; refer to the data sheet [dBm]. UP and DOWN increment/decrement the source power in 0.1-dB steps. |
*RST value |
–25 dBm
|
SCPI, Command Types |
Device-specific, command or query.
|
Example: |
*RST; SOUR:FREQ:CONV:MIX:PFIX –10 Reset the analyzer and specify a fixed power of –10 dBm. SOUR:FREQ:CONV:MIX:FUND LO Assign the fundamental frequency to the LO signal. The fixed power is automatically assigned to the RF signal.
|
Defines a port group numbered <group_no> containing a continuous range of logical ports between <log_port1> and <log_port2>.
<Ch> |
Channel number.
|
<group_no> |
Port group number. If unspecified the analyzer automatically selects an unused port group number (existing port groups are not overwritten).
|
Range [def. unit] |
Port groups must contain at least one logical port and must not overlap, so the maximum number of port groups for an n-port analyzer is n. [–]
|
<log_port1>, <log_port2> |
First and last logical port number in the port group. The port group contains all ports with numbers between <log_port1> and <log_port2>. The command generates an error message if only one parameter is transferred. Both parameters must be omitted if the command is used as a query. |
Range [def. unit] |
1 to n where n is the number of ports of the analyzer. <log_port1> can be smaller than, equal to or larger than <log_port2>, however, a physical port cannot be assigned to several port groups. [–]
|
SCPI, Command Types |
Device-specific, command or query
|
Example: |
On a 4-port analyzer, arrange the logical ports no. 1 and 2 in port group 1, the logical ports no 3 and 4 in port group 2.
Query the port group no. 1. The response is 1,2.
Dissolve all port group and repeat the query. The response is 1,4: the default port group no. 1 contains all ports.
Redefine the port group, removing port 3.
Query the number of port groups. The response is 1.
|
Dissolves a group of measured ports <group_no> or all port groups.
<Ch> |
Channel number.
|
<group_no> |
Port group number. If unspecified the numeric suffix is set to 1.
|
Range [def. unit] |
Range according to the current port groups (SOURce<Ch>:GROup<group_no>). If an undefined port group number is used, the analyzer generates an error message. Exception: Parameter ALL, see below. [–] Note: Port group no 1 is always present and can not be dissolved. After a *RST or after SOURce<Ch>:GROup<group_no>:CLEar ALL, port group no. 1 contains all ports of the analyzer.
|
ALL |
If ALL is specified, all port groups are dissolved (exception: port group 1; see above); the <group_no> suffix is ignored. If ALL is omitted, only the specified port group is dissolved. |
SCPI, Command Types |
Device-specific, no query
|
Example: |
See SOURce<Ch>:GROup<group_no>
|
Queries the number of port groups in channel no. <Ch>.
<Ch> |
Channel number.
|
<group_no> |
Port group number. This suffix is ignored, because the command returns the number of all port groups.
|
Range [def. unit] |
Port groups must contain at least one logical port and must not overlap, so the maximum number of port groups for an n-port analyzer is n. [–] Note: Port group no 1 is always present and can not be dissolved. After a *RST or after SOURce<Ch>:GROup<group_no>:CLEar ALL, port group no. 1 contains all ports of the analyzer.
|
SCPI, Command Types |
Device-specific, query only
|
Example: |
See SOURce<Ch>:GROup<group_no>
|
Defines a port group numbered <group_no> containing an arbitrary selection of logical ports. The ports do not have to be numbered continuously (as for port groups defined via SOURce<Ch>:GROup<group_no>).
It is not possible to create more than one port group with arbitrary ports. To avoid errors, use the setting command only while the channel contains a single port group (e.g. after a *RST). You can use the query to read out the ports for an arbitrary number of port groups created via SOURce<Ch>:GROup<group_no>.
<Ch> |
Channel number.
|
<group_no> |
Port group number.
|
Range [def. unit] |
Port groups must contain at least one logical port and must not overlap, so the maximum number of port groups for an n-port analyzer is n. [–]
|
<log_port1>, ... |
Numbers of all logical ports in the port group. The port numbers must be omitted if the command is used as a query. |
Range [def. unit] |
For each parameter: 1 to n where n is the number of ports of the analyzer. The port numbers must all be different. Besides, a physical port cannot be assigned to several port groups. [–]
|
SCPI, Command Types |
Device-specific, command or query
|
Example: |
See SOURce<Ch>:GROup<group_no>
|
Defines a balanced port numbered <log_port>, combining two physical ports <phys_port1> and <phys_port2>.
A balanced port configuration generally introduces a new set of mixed mode measured quantities. Therefore the traces must be redefined when a balanced port is created. To avoid any inconsistencies the analyzer deletes all traces when SOURce<Ch>:LPORt<log_port> is used.
<Ch> |
Channel number.
|
<log_port> |
Logical port number used to number balanced or physical ports. If unspecified the numeric suffix is set to 1.
|
Range [def. unit] |
One balanced port requires two physical ports, so the maximum number of balanced ports for an n-port analyzer is n/2 (n even) or (n – 1)/2 (n odd). If the command is used as a query, then <log_port> can range up to n (no balanced ports, see example below). [–]
|
<phys_port1>, <phys_port2> |
Physical port numbers. The command has no effect if only one parameter is transferred. Both parameters must be omitted if the command is used as a query. |
Range [def. unit] |
1 to n where n is the number of ports of the analyzer. The port numbers must be different from each other. Moreover, a physical port cannot be assigned to several physical ports. [–]
|
SCPI, Command Types |
Device-specific, command or query
|
Example: |
Assuming that the analyzer provides 4 test ports, combine the physical ports 1 and 2 to the logical port 1, the physical ports 3 and 4 to the logical port 2.
Query the physical ports assigned to logical port no. 1. The response is 1,2.
Dissolve all logical ports and repeat the query. The response is 1: the logical port no. 1 is identical to the physical port no. 1.
|
Dissolves a balanced port numbered <log_port> or all balanced ports.
<Ch> |
Channel number.
|
<log_port> |
Logical port number used to number balanced ports. If unspecified the numeric suffix is set to 1.
|
Range [def. unit] |
Range according to the current port configuration (SOURce<Ch>:LPORt<log_port>). If an undefined balanced port number is used, the analyzer generates an error message. Exception: Parameter ALL, see below. [–]
|
ALL |
If ALL is specified, all balanced ports are dissolved; the <log_port> suffix is ignored. If ALL is omitted, only the specified balanced port is dissolved. |
SCPI, Command Types |
Device-specific, no query
|
Example: |
See SOURce<Ch>:LPORt<log_port>
|