SOURce<Ch>:...    Related Topics  

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

[:CW] | FIXed

:CONVersion

:ARBitrary

:CFRequency

:EFRequency

:IFRequency

:MIXer

:FUNDamental

:PAFixed

:PFIXed

:GROup

:CLEar

:COUNt

:PORTs

:LPORt

:CLEar

:POWer

:COMBiner

:CORRection(source power calibration commands)

[:LEVel|

[:IMMediate]

[:AMPLitude]

:OFFset

:SLOPe

:STARt

:STATe

:STOP

: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.  


SOURce<Ch>:FREQuency<Pt>[:CW] <fixed frequency>
SOURce<Ch>:FREQuency<Pt>:FIXed <fixed frequency>

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:

FUNC "XPOW:POW:A1"

Activate a power sweep and select the wave quantity a1 as measured parameter for channel and trace no. 1.

SOUR:FREQ:CW 100 MHz

Set the CW frequency to 100 MHz.

 

 


SOURce<Ch>:FREQuency<Pt>:CONVersion:ARBitrary:CFRequency
<numerator>, <denominator>, <offset>, CW | FIXed | SWEep

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>
<denominator>
<offset>

Parameters of the frequency formula. The source frequency fs is calculated according to
fs = <numerator>/<denominator>*fb. + <offset>
where fb represents the sweep range (for frequency sweeps, parameter SWEep). For power, time and CW Mode sweeps (parameters CW or FIXed), fb = 0.  

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:
<numerator> – Values are rounded to positive or negative integer numbers [1]
<denominator> – Values are rounded to positive integer numbers [1]
<offset> – Values are rounded to (positive or negative) multiples of 1 Hz [Hz].

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.
<numerator> = <denominator> = 1
<offset> = 0 Hz

 

Sweep type Parameters

SWEep – A frequency sweep is active, the command defines a frequency range.
CW | FIXed – A power, time or CW Mode sweeps is active, the command defines a fixed frequency.

*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..

 

 


SOURce<Ch>:FREQuency<Pt>:CONVersion:ARBitrary:EFRequency<Gen>
<Boolean>, <numerator>, <denominator>, <offset>, CW | FIXed | SWEep

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>
<denominator>
<offset>

Parameters of the frequency formula. The source frequency fs is calculated according to
fs = <numerator>/<denominator>*fb. + <offset>
where fb represents the sweep range (for frequency sweeps, parameter SWEep). For power, time and CW Mode sweeps (parameters CW or FIXed), fb = 0.  

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:
<numerator> – Values are rounded to positive or negative integer numbers [1]
<denominator> – Values are rounded to positive integer numbers; zero is not allowed [1]
<offset> – Values are rounded to (positive or negative) multiples of 1 Hz [Hz].

*RST value

The default frequency/frequency range corresponds to the sweep range or CW frequency of the analyzer, i.e.
<numerator> = <denominator> = 1
<offset> = 0 Hz

 

Sweep type Parameters

SWEep – A frequency sweep is active, the command defines a frequency range.
CW | FIXed – A power, time or CW Mode sweeps is active, the command defines a fixed frequency.

*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.   

 

 


SOURce<Ch>:FREQuency<Pt>:CONVersion:ARBitrary:IFRequency
<numerator>, <denominator>, <offset>, CW | FIXed | SWEep

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>
<denominator>
<offset>

Parameters of the frequency formula. The source frequency fs is calculated according to
fs = <numerator>/<denominator>*fb. + <offset>
where fb represents the sweep range (for frequency sweeps, parameter SWEep). For power, time and CW Mode sweeps (parameters CW or FIXed), fb = 0.  

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:
<numerator> – Values are rounded to positive or negative integer numbers [1]
<denominator> – Values are rounded to positive integer numbers; zero is not allowed [1]
<offset> – Values are rounded to (positive or negative) multiples of 1 Hz [Hz].

*RST value

The default frequency/frequency range corresponds to the sweep range or CW frequency of the analyzer, i.e.
<numerator> = <denominator> = 1
<offset> = 0 Hz

 

Sweep type Parameters

SWEep – A frequency sweep is active, the command defines a frequency range.
CW | FIXed – A power, time or CW Mode sweeps is active, the command defines a fixed frequency.

*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.  

 

 


SOURce<Ch>:FREQuency<Pt>:CONVersion:MIXer:FUNDamental RF | LO

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
LO – local oscillator signal

*RST value

RF

 

SCPI, Command Types

Device-specific, command or query.

 

Example:

See SOURce<Ch>:FREQuency:CONVersion:MIXer:PFIXed

 

 


SOURce<Ch>:FREQuency<Pt>:CONVersion:MIXer:PAFixed <aux_fixed_power>

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.

 

 


SOURce<Ch>:FREQuency<Pt>:CONVersion:MIXer:PFIXed <fixed_power>

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.  

 

 


SOURce<Ch>:GROup<group_no>  <log_port1>,<log_port2>

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:

SOUR:GRO1 1,2; :SOUR:GRO2 3,4

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.

SOUR:GRO?

Query the port group no. 1. The response is 1,2.

SOUR:GRO:CLE ALL; :SOUR:GRO1?

Dissolve all port group and repeat the query. The response is 1,4: the default port group no. 1 contains all ports.

SOUR:GRO:PORT 1,2,4

Redefine the  port group, removing port 3.

SOUR:GRO:PORT?; :SOUR:GRO1?

Query the ports in the port group using two different methods. The response is 1,2,4;1,4.

SOUR:GRO:COUN?

Query the number of port groups. The response is 1.

 


SOURce<Ch>:GROup<group_no>:CLEar [ALL]

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>

 

 


SOURce<Ch>:GROup<group_no>:COUNt?

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>

 

 


SOURce<Ch>:GROup<group_no>:PORTs  <log_port1>{,<log_port2> ...}

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>

 


SOURce<Ch>:LPORt<log_port>  <phys_port1>,<phys_port2>

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:

*RST; :SOUR:LPOR1 1,2; LPOR2 3,4

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.

SOUR:LPOR1?

Query the physical ports assigned to logical port no. 1. The response is 1,2.

SOUR:LPOR:CLE ALL
SOUR:LPOR1?

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.

 

 


SOURce<Ch>:LPORt<log_port>:CLEar [ALL]

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>

 

 


SOURce<Ch>:POWer<Pt>:COMBiner <Boolean>

Switches the two-tone combiner for test ports 1 and 3 on or off. The command is available for R&S ZVT20 network analyzers that are equipped with option R&S ZVT20-B11, Combiner.

<Ch>

Calibrated channel number  

 

<Pt>

Calibrated port number. This suffix is ignored; the analyzer always combines the source signals at ports 1 and 3.

 

<Boolean>

Switches the two-tone combiner on (ON) or off (OFF).

*RST value

OFF [–]

 

SCPI, Command Types

Device-specific, command or query

 

Example:

*RST; ::SOUR:POW1:PERM ON; :SOUR:POW3:PERM ON

Reset the instrument and ensure that the generators at ports 1 and 3 are permanently on.  

FREQ:STAR 9E+8; STOP 1.1E+9

Set a frequency range of 900 MHz to 1.1 GHz. This range is valid for ports 1 and 3.  

SOUR:FREQ3:CONV:ARB:IFR  1, 1, 1E+6, SWE

Shift the frequency at port 3 by 1 MHz.  

SOUR:POW:COMB ON

Switch the combiner on, generating a permanent two-tone signal at port 1.