SOURce<Ch>:POWer[:LEVel]

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>:POWer<Pt>:ALC:CLAMp <Boolean>

Suspends the ALC mechanism at source port <Pt> while the analyzer acquires measurement data (Clamp ALC during Measurement).

<Ch>	Channel number
<Pt>	Port number
<Boolean>	ON \| OFF - Clamp ALC... on or off.
*RST value	OFF
SCPI, Command Types	Device-specific, command or query.
Example:	See SOURce<Ch>:POWer<Pt>:ALC:CONTrol

SOURce<Ch>:POWer<Pt>:ALC:CONTrol <Boolean>

Enables or disables individual ALC (Automatic Level Control) settings at source port <Pt>.

<Ch>	Channel number
<Pt>	Port number
<Boolean>	Enables (ON) or disables (OFF) individual ALC settings.
*RST value	OFF [–]
SCPI, Command Types	Device-specific, command or query
Example:	DIAG:ALC:SETT ON Disable the ALC function. SOUR:POW2:ALC:CONT ON Enable individual ALC settings at port 2. SOUR:POW2:ALC:CLAM ON Suspend the ALC during the measurement. SOUR:POW2:ALC:PIP MAN; :SOUR:POW2:ALC:PIP:GAIN 0.35; ITIM 6E-7 Enable manual entry of PI controller parameters and define the proportional gain and the integration time. SOUR:POW2:ALC OFF Disable ALC at port 2. The other analyzer ports are not affected.

SOURce<Ch>:POWer<Pt>:ALC:PIParameter AUTO | MANual

Enables automatic or manual setting of the PI controller parameters at source port <Pt>.

<Ch>	Channel number
<Pt>	Port number
Parameters	AUTO – Automatic setting, depending on the bandwidth (DIAGnostic:ALC:BW) MANual – Manual setting using DIAGnostic:ALC:PIParameter:GAIN and DIAGnostic:ALC:PIParameter:ITIMe.
*RST value	NORMal
SCPI, Command Types	Device-specific, command or query.
Example:	See SOURce<Ch>:POWer<Pt>:ALC:CONTrol

SOURce<Ch>:POWer<Pt>:ALC:PIParameter:GAIN <prop_gain>

Defines the proportional gain of the PI controller at source port <Pt>. This setting takes effect when manual setting of the controller parameters is enabled (DIAGnostic:ALC:PIParameter MANual).

<Ch>	Channel number
<Pt>	Port number
<prop_gain>	Proportional gain setting
Range [def. unit]	0 dB to 100 dB [dB]. UP and DOWN increment the proportional gain in 0.001 dB steps.
*RST value	0.4 dB
SCPI, Command Types	Device-specific, command or query.
Example:	See SOURce<Ch>:POWer<Pt>:ALC:CONTrol

SOURce<Ch>:POWer<Pt>:ALC:PIParameter:ITIMe <int_time>

Defines the integration time of the PI controller at source port <Pt>. This setting takes effect when manual setting of the controller parameters is enabled (DIAGnostic:ALC:PIParameter MANual).

<Ch>	Channel number
<Pt>	Port number
<prop_gain>	Integration time setting
Range [def. unit]	10 ns to 100 s [s]. UP and DOWN increment the integration time in 10 ns steps.
*RST value	500 ns
SCPI, Command Types	Device-specific, command or query.
Example:	See SOURce<Ch>:POWer<Pt>:ALC:CONTrol

SOURce<Ch>:POWer<Pt>:ALC[:STATe] <Boolean>

Enables or disables ALC (Automatic Level Control) at source port <Pt>.

<Ch>	Channel number
<Pt>	Port number
<Boolean>	Enables (ON) or disables (OFF) ALC.
*RST value	OFF [–]
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>:ALC:CONTrol

SOURce<Ch>:POWer<Pt>:GENerator<Gen>:LLIMit[:STATe] <Boolean>

Enables or disables the limit for the source power of an external generator no. <Gen>. The limit is defined using SOURce<Ch>:POWer<Pt>:GENerator<Gen>:LLIMit:VALue.

<Ch>	Channel number. This suffix is ignored; the setting applies to all channels.
<Pt>	Test port number of the analyzer. This suffix is ignored; the generator is selected via <Gen>.
<Gen>	Generator number
<Boolean>	ON \| OFF: Enable or disable the power limit.
*RST value	The power limit settings are not changed after a *RST. The factory setting is OFF.
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]LLIMit:VALue

SOURce<Ch>:POWer<Pt>:GENerator<Gen>:LLIMit:VALue <limit>

Defines a limit for the source power of an external generator no. <Gen>. The limit must be enabled explicitly using SOURce<Ch>:POWer<Pt>:GENerator<Gen>:LLIMit[:STATe].

<Ch>	Channel number. This suffix is ignored; the limit applies to all channels.
<Pt>	Test port number of the analyzer. This suffix is ignored; the generator is selected via <Gen>.
<Gen>	Generator number
<limit>	Limit for the generator power.
Range [def. unit]	Depending on the generator model [dBm]. UP and DOWN increment/decrement the generator power limit in 0.1-dB steps.
*RST value	The power limit is not changed after a *RST. The factory setting is 0 dBm.
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]LLIMit:VALue

SOURce<Ch>:POWer<Pt>:GENerator<Gen>:OFFSet
<numeric_value>, ONLY | CPADd

Defines the power of an external generator or its power offset relative to the channel power (SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate][:AMPlitude]).

<Ch>	Channel number.
<Pt>	Test port number of the analyzer. This suffix is ignored; the generator is selected via <Gen>.
<Gen>	Generator number
<numeric_value>	Port-specific power offset.
Range [def. unit]	–300 dB to +300 dB [dB]. UP and DOWN increment/decrement the phase in 1-dB steps.
*RST value	0 dB
Offset parameters	ONLY – only the port-specific power is used; the channel power is ignored. CPADd – the port-specific power is added as an offset to the channel power.
*RST value	CPADd
SCPI, Command Types	Device-specific, command or query
Example:	*RST; SOUR:POW -6 Reset the instrument, activating a frequency sweep and set the internal source power (channel power) for the default channel 1 to -6 dBm. SYST:COMM:RDEV:GEN1:DEF 'Ext. Gen. 1', 'SME02', 'gpib0', '21'; SYST:COMM:RDEV:GEN2:DEF 'Ext. Gen. 2', 'SME02', 'gpib0', '22' Configure an R&S SME02 generator as external generator no. 1, assigning the name Ext. Gen. 1 and a GPIB address 21. Configure a second R&S SME02 generator, assigning the name Ext. Gen. 2 and a GPIB address 22. SOUR:POW:GEN1:OFFS 6, ONLY; :SOUR:POW:GEN2:OFFS 6, CPAD Set the source power of generator no. 1 to +6 dBm, the source power of generator no. 2 to 0 dBm.

SOURce<Ch>:POWer<Pt>:GENerator<Gen>:PERManent[:STATe] <Boolean>

Defines whether the external generator power is permanently on.

<Ch>	Channel number.
<Pt>	Test port number of the analyzer. This suffix is ignored; the generator is selected via <Gen>.
<Gen>	Generator number
<Boolean>	ON - Power at port <Pt> is permanently on OFF - Power is only on for the partial measurements that require the port as a drive port.
*RST value	OFF
SCPI, Command Types	Device-specific, command or query
Example:	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:POW:GEN:PERM ON Activate a permanent external generator signal.

SOURce<Ch>:POWer<Pt>:GENerator<Gen>:STATe <Boolean>

Turns an external generator numbered <Gen> on or off.

<Ch>	Channel number.
<Pt>	Test port number of the analyzer. This suffix is ignored; the generator is selected via <Gen>.
<Gen>	Generator number
<Boolean>	ON \| OFF - Generator is on or off
*RST value	ON
SCPI, Command Types	Device-specific, command or query
Example:	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:POW:GEN:STAT OFF Turn the external generator off. In the Port Configuration dialog, RF Off is checked for generator no. 1.

SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate][:AMPLitude] <power>

Defines the power of the internal signal source (channel power). The setting is valid for all sweep types except power sweep.

Use SOURce<Ch>:POWer<Pt>:STARt and SOURce<Ch>:POWer<Pt>:STOP to define the sweep range for a power sweep.

<Ch>	Channel number.
<Pt>	Test port number of the analyzer. This suffix is ignored because the selected channel power applies to all source ports used in the active channel. It is possible though to define a port-specific power limit (SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]LLIMit:VALue) and a slope factor for the source power (SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]:SLOPe). Moreover, it is possible to define a port-specific power offset (SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]:OFFSet).
<power>	Internal source power.
Range [def. unit]	–40 dBm to +10 dBm. The exact range depends on the analyzer model; refer to the data sheet [dBm]. UP and DOWN increment/decrement the source power in 0.1-dB steps.
*RST value	–10 dBm
SCPI, Command Types	Confirmed, command or query
Example:	FUNC "XFR:POW:RAT B1, A2" Activate a frequency sweep and select the ratio B1/A2 as measured parameter for channel and trace no. 1. SOUR:POW -6 Set the internal source power for channel 1 to -6 dBm. `SOUR:POW2:SLOP 10` Set the power slope factor for the wave transmitted at port 2 to 10 dB/GHz. The internal source power and the waves at the other test ports are not affected.

SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]:LLIMit:DGRaccess <Boolean>

Optimizes the automatic level control (ALC) for test setups where the additional connectors of option R&S ZVT-B16 are used. If the optimization is enabled, the ALC is limited to +1 dB so that the active port power limits cannot be exceeded by more than 1 dB.

This command is unavailable unless option R&S ZVT-B16, Direct Generator and Receiver Access, is installed.

<Ch>	Channel number. This suffix is ignored; the setting applies to all channels.
<Pt>	Test port number of the analyzer. This suffix is ignored; the setting applies to all ports.
<Boolean>	ON \| OFF: Optimize ALC for additional connectors \| use normal ALC algorithm
*RST value	The setting is not changed after a *RST. The factory setting is OFF.
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]LLIMit:VALue

SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]:LLIMit[:STATe] <Boolean>

Enables or disables the limit for the source power at port no. <Pt>. The limit is defined using SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]LLIMit:VALue.

<Ch>	Channel number. This suffix is ignored; the setting applies to all channels.
<Pt>	Test port number of the analyzer.
<Boolean>	ON \| OFF: Enable or disable the power limit.
*RST value	The power limit settings are not changed after a *RST. The factory setting is OFF.
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]LLIMit:VALue

SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]:LLIMit:VALue <limit>

Defines a limit for the source power at port no. <Pt>. The limit must be enabled explicitly; see example.

<Ch>	Channel number. This suffix is ignored; the limit applies to all channels.
<Pt>	Test port number of the analyzer.
<limit>	Limit for the internal source power at port no. <Pt>.
Range [def. unit]	–40 dBm to +10 dBm. The exact range depends on the analyzer model; refer to the data sheet [dBm]. UP and DOWN increment/decrement the source power limit in 0.1-dB steps.
*RST value	The power limit is not changed after a *RST. The factory setting is 0 dBm.
SCPI, Command Types	Device-specific, command or query
Example:	SOUR:POW2:LLIM:VAL -10; STAT ON Limit the analyzer source power at port 2 to –10 dBm and enable the source power limit. SOUR:POW2:LLIM:DGR ON Optimize the automatic level control (ALC) for additional connectors (option R&S ZVT-B16). 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:POW3:GEN:LLIM:VAL -10; STAT ON Limit the power of the external generator port 3 to –10 dBm and enable the source power limit.

SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]:OFFSet
<numeric_value>, ONLY | CPADd

Defines a port-specific source power or a power offset relative to the channel power (SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate][:AMPlitude]). An additional Cal Power Offset can be defined via SOURce<Ch>:POWer<Pt>:CORRection:LEVel:OFFSet.

<Ch>	Channel number.
<Pt>	Test port number of the analyzer.
<numeric_value>	Port-specific power offset.
Range [def. unit]	–300 dB to +300 dB [dB]. UP and DOWN increment/decrement the phase in 1-dB steps.
*RST value	0 dB
Offset parameters	ONLY – only the port-specific power is used; the channel power is ignored. CPADd – the port-specific power is added as an offset to the channel power.
*RST value	CPADd
SCPI, Command Types	Confirmed (with additional device-specific character data parameters), command or query
Example:	*RST; SOUR:POW -6 Reset the instrument, activating a frequency sweep and set the internal source power (channel power) for the default channel 1 to -6 dBm. SOUR:POW1:OFFS 6, ONLY; SOUR:POW2:OFFS 6, CPAD Replace the source power at port 1 by +6 dBm, the source power at port 2 by 0 dBm. The powers at the remaining ports (if available) are not affected.

SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate]:SLOPe <numeric_value>

Defines a linear factor to modify the internal source power at port <Pt> as a function of the stimulus frequency.

<Ch>	Channel number.
<Pt>	Test port number of the analyzer.
<numeric_value>	Port-specific slope factor.
Range [def. unit]	–40 dB/GHz to +40 dB/GHz. The resulting power range over the entire frequency sweep must be within the power range of the analyzer; refer to the data sheet [dBm]. UP and DOWN increment/decrement the source power in 0.1-dB/GHz steps.
*RST value	0 dB/GHz
SCPI, Command Types	Device-specific, command or query
Example:	See SOURce<Ch>:POWer<Pt>[:LEVel][:IMMediate][:AMPlitude]

SOURce<Ch>:POWer<Pt>:PERManent[:STATe] <Boolean>

Defines whether the source power is permanently on.

<Ch>	Channel number.
<Pt>	Test port number of the analyzer.
<Boolean>	ON - Power at port <Pt> is permanently on OFF - Power is only on for the partial measurements that require the port as a drive port.
*RST value	OFF
SCPI, Command Types	Device-specific, command or query
Example:	SOUR:POW2:STAT ON Switch the RF power at port no. 2 on. SOUR:POW2:PERM ON Activate a permanent signal source.

SOURce<Ch>:POWer<Pt>:STARt <numeric_value>

Defines the start power for a power sweep which is equal to the left edge of a Cartesian diagram. A power sweep must be active ([SENSe<Ch>:]SWEep:TYPE POWer) before this command can be used.

<Ch>	Channel number.
<Pt>	Test port number of the analyzer. This suffix is ignored because the selected power sweep range applies to all source ports used in the active channel.
<numeric_value>	Start power of the sweep.
Range [def. unit]	–40 dBm to +9.99 dBm. The exact range depends on the analyzer model; refer to the data sheet [dBm]. UP and DOWN increment/decrement the source power in 1-dB steps.
*RST value	–25 dBm
SCPI, Command Types	Confirmed, command or query
Example:	SWE:TYPE POW Activate a power sweep. SOUR:POW:STAR -6; STOP 10 Select a power sweep range between –6 dBm and +10 dBm.

Note: If the start power entered is greater than the current stop power (SOURce<Ch>:POWer<Pt>:STOP), the stop power is set to the start power plus the minimum power span of 0.01 dB.

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

Turns the RF source power at a specified test port on or off.

<Ch>	Channel number.
<Pt>	Test port number of the analyzer.
<Boolean>	ON \| OFF - Turns the internal source power at the specified test port no. <Pt> on or off.
*RST value	ON
SCPI, Command Types	Device-specific, command or query
Example:	*RST; SOUR:POW -6 Set the internal source power for channel 1 and all test ports to -6 dBm. SOUR:POW2:STAT? Query whether the source power at test port 2 is on. The analyzer returns a 1.

SOURce<Ch>:POWer<Pt>:STOP <numeric_value>

Defines the stop power for a power sweep which is equal to the right edge of a Cartesian diagram. A power sweep must be active ([SENSe<Ch>:]SWEep:TYPE POWer) before this command can be used.

<Ch>	Channel number.
<Pt>	Test port number of the analyzer. This suffix is ignored because the selected power sweep range applies to all source ports used in the active channel.
<numeric_value>	Stop power of the sweep.
Range [def. unit]	–39.99 dBm to +10 dBm. The exact range depends on the analyzer model; refer to the data sheet [dBm]. UP and DOWN increment/decrement the source power in 1-dB steps.
*RST value	0 dBm
SCPI, Command Types	Confirmed, command or query
Example:	SWE:TYPE POW Activate a power sweep. SOUR:POW:STAR -6; STOP 10 Select a power sweep range between –6 dBm and +10 dBm.

If the stop power entered is smaller than the current start power (SOURce<Ch>:POWer<Pt>:STARt), the start power is set to the stop power minus the minimum power span of 0.01 dB.

SOURce<Ch>:POWer...