Source SCPI

M9370A / M9371A / M9372A / M9374A / M9375A

Source Commands


Controls the power delivered to the DUT.

SOURce:

CATalog?

POWer

       | ATTenuation

            | AUTO

       | CENTer

       | COUPle

       | DETector

       | [LEVel]

            | [IMMediate][AMPLitude]

            | SLOPe

                 | STATe

       | MODE

       | PORT

            | STARt

            | STOP

       | SPAN

       | STARt

       | STOP

Click on a keyword to view the command details.

See Also


SOURce<cnum>:CATalog?

(Read-only) Returns a list of valid port names that can be controlled. Some ports only have string names, NOT numbers. All commands that require a port argument have provisions for specifying either a port number OR a string name.

See also: Remotely Specifying a Source Port.

Parameters

 

Examples

SOUR:CAT?
source:catalog

'Some PNA-X models return
"Port 1,Port 2,Port 3,Port 4,Port 1 Src2"

Return Type

Comma-separated list of strings.

Default

Not applicable


SOURce<cnum>:POWer<port>:ATTenuation <num>, [src]

(Read-Write) Sets the attenuation level for the selected channel. Sending this command turns automatic attenuation control (SOUR:POW:ATT:AUTO) to OFF. If the ports are coupled, changing the attenuation on one port will also change the attenuation on all other ports. To turn port coupling OFF use SOURce:POWer:COUPle OFF.

Note: Attenuation cannot be set with Sweep Type set to Power

See Sens:Power:ATT to change receiver attenuation.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<port>

Source port number of the PNA. If unspecified, value is set to 1. To make settings for ports that are not simple numbers, use the [src] argument.

<num>

Attenuation value.  The range of settable values depends on the PNA model. To determine the valid settings, do one of the following:

  • See PNA models and options to see the range and step size for each model / option.

  • Perform a query using MAX, then MIN, as an argument. Example: SOURce:POWer:ATT? Max  However, this will not tell you the attenuation step size.

If an invalid attenuation setting is entered, the PNA will select the next lower valid value. For example, if 19 is entered, then for an E8361A,  10 dB attenuation will be selected.

Note: This command will accept MIN or MAX instead of a numeric parameter. See SCPI Syntax for more information.

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports such as an external source, true mode balanced port, or one of the Source 2 outputs on the 2-port 2-source PNA-X model such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOUR:POW:ATT 10

source2:power2:attenuation maximum

source:power:att 20, "Port 1 Src2"

Query Syntax

SOURce<cnum>:POWer<port>:ATTenuation? [min/max] [src] [min/max,src]

Return Type

Numeric

Default

0


SOURce<cnum>:POWer<port>:ATTenuation:AUTO <bool>, [src]

(Read-Write) Turns automatic attenuation control ON or OFF. Setting an attenuation value (using SOURce:POWer:ATTenuation <num>) sets AUTO OFF.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1.

<port>

Source port number of the PNA. If unspecified, value is set to 1.To make settings for ports that are not simple numbers, use the [src] argument.

<bool>

ON (or 1) - turns coupling ON. The analyzer automatically selects the appropriate attenuation level to meet the specified power level.

OFF (or 0) - turns coupling OFF. Attenuation level must be set using SOURce:POWer:ATTenuation <num>.

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports such as an external source, true mode balanced port, or one of the Source 2 outputs on the 2-port 2-source PNA-X model such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOUR:POW2:ATT:Auto On

source2:power:attentuation:auto off

sour:pow:att:auto 1, "Port 1 Src2"

Query Syntax

SOURce<cnum>:POWer:ATTenuation:Auto? [src]

Return Type

Boolean (1 = ON, 0 = OFF)

Default

ON


SOURce<cnum>:POWer<port>:CENTer <num>

(Read-Write) Sets the power sweep center power. Must also set:
SENS:SWE:TYPE POWer
and SOURce:POWer:SPAN <num>.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<num>

Center power. Actual achievable leveled power depends on frequency.

<port>

If provided, this argument is ignored by the PNA.

Examples

SOUR:POW:CENT -15
source2:power:center -7

Query Syntax

SOURce<cnum>:POWer:CENTer?

Return Type

Numeric

Default

0 dBm


SOURce<cnum>:POWer<port>:COUPle <ON | OFF>

(Read-Write) Turns Port Power Coupling ON or OFF.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<ON | OFF>

ON (or 1) - turns coupling ON. The same power level is used for both source ports.

OFF (or 0) - turns coupling OFF.  Power level can be set individually for each source port.

<port>

If provided, this argument is ignored by the PNA.

Examples

SOUR:POW:COUP ON
source2:power:couple off

Query Syntax

SOURce<cnum>:POWer:COUPle?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

ON


SOURce<cnum>:POWer:DETector <char> OBSOLETE

(Read-Write) The PNA models with external leveling are now OBSOLETE.

Sets the source leveling loop as Internal or External.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<char>

INTernal - Internal leveling is applied to the source

EXTernal - External leveling is applied to the source through a rear-panel connector.  ONLY provided on 3 GHz, 6 GHz, and 9 GHz PNA models.

Examples

SOUR:POW:DET INT
source2:power:detector external

Query Syntax

SOURce<cnum>:POWer:DETector?

Return Type

Character

Default

INTernal


SOURce<cnum>:POWer<port>[:LEVel][:IMMediate][:AMPLitude] <num>, [src]

(Read-Write) Sets the RF power output level.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<port>

Source port number of the PNA. If unspecified, value is set to 1. To make settings for ports that are not simple numbers, use the [src] argument.

<num>

Source power in dBm.

Note: The range of settable power values depends on the PNA model and if source attenuators are installed. To determine the range of values, perform a query using MAX, then MIN, as an argument. (SOUR:POW:ATT:AUTO must be set to ON)  Example: SOURce:POWer? Max

Actual achievable leveled power depends on frequency.

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports such as an external source, true mode balanced port, or one of the Source 2 outputs on the 2-port 2-source PNA-X model such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOUR:POW1 5
source2:power:level:immediate:amplitude maximum

sour:pow 5, "Port 1 Src2"

Query Syntax

SOURce<cnum>:POWer[:LEVel][:IMMediate][:AMPLitude]? [src]

Return Type

Numeric

Default

0 dBm


SOURce<cnum>:POWer<port>[:LEVel]:SLOPe <num>

(Read-Write) Sets the RF power slope value.

Also enable the slope state using SOUR:POW:SLOP:STAT ON.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<num>

Slope value in db/GHz. Choose any value between -2 and 2 (0 is no slope).

<port>

If provided, this argument is ignored by the PNA.

Examples

SOUR:POW:SLOP .5234434

source2:power:level slope -1.345

Query Syntax

SOURce<cnum>:POWer[:LEVel]:SLOPe?

Return Type

Numeric

Default

0


SOURce<cnum>:POWer<port>[:LEVel]:SLOPe:STATe <ON | OFF>

(Read-Write) Turns Power Slope ON or OFF. Set the slope using SOUR:POW:SLOP.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<ON|OFF>

ON (or 1) - turns slope ON.

OFF (or 0) - turns slope OFF.

<port>

If provided, this argument is ignored by the PNA.

Examples

SOUR:POW:SLOP:STAT ON
source2:power:slope:state off

Query Syntax

SOURce<cnum>:POWer[:LEVel]:SLOPe:STATe?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF


SOURce<cnum>:POWer<port>:MODE <state>, [src]

(Read-Write) Sets the state of PNA source for the specified port.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<port>

Source port number of the PNA. If unspecified, <port> is set to 1. To make settings for ports that are not simple numbers, use the [src] argument.

<state>

Source state. Choose from:

  • AUTO  Source power is turned ON when required for a measurement.

  • ON  Source power is always ON regardless of the measurement.

  • OFF  Source power is always OFF regardless of the measurement.

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports such as an external source, true mode balanced port, or one of the Source 2 outputs on the 2-port 2-source PNA-X model such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOUR:POW:MODE ON

source2:power4:mode OFF

sour:pow:mode on, "Port 1 Src2"

Query Syntax

SOURce<cnum>:POWer<port>:MODE? [src]

Return Type

Character

Default

Auto


SOURce<cnum>:POWer<port>:PORT:STARt <num>, [src]

(Read-Write) Sets and reads the power sweep start power value for a specific port. This allows uncoupled forward and reverse power sweep ranges. Must also set SENS:SWE:TYPE POWer and SOUR:POW:COUPle OFF.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<port>

Source port number of the PNA. If unspecified, <port> is set to 1. To make settings for ports that are not simple numbers, use the [src] argument.

<num>

Start power in dBm.

Note: The range of settable power values depends on the PNA model and if source attenuators are installed. To determine the range of values, perform a query using MAX, then MIN, as an argument. (SOUR:POW:ATT:AUTO must be set to ON)  Example: SOURce:POWer:STARt? MIN

Actual achievable leveled power depends on frequency.

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports such as an external source, true mode balanced port, or one of the Source 2 outputs on the 2-port 2-source PNA-X model such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOUR:POW1:PORT:STAR -15
source2:power:port:start 5, "bal port 1"

Query Syntax

SOURce<cnum>:POWer<port>:PORT:STARt? [src]

Return Type

Numeric

Default

-10 dBm


SOURce<cnum>:POWer<port>:PORT:STOP <num>, [src]

(Read-Write) Sets and reads the power sweep stop power value for a specific port. This allows uncoupled forward and reverse power sweep ranges. Must also set SENS:SWE:TYPE POWer and SOUR:POW:COUPle OFF.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<port>

Source port number of the PNA. If unspecified, <port> is set to 1. To make settings for ports that are not simple numbers, use the [src] argument.

<num>

Stop power in dBm.

Note: The range of settable power values depends on the PNA model and if source attenuators are installed. To determine the range of values, perform a query using MAX, then MIN, as an argument. (SOUR:POW:ATT:AUTO must be set to ON)  Example: SOURce:POWer:STARt? MIN

Actual achievable leveled power depends on frequency.

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports such as an external source, true mode balanced port, or one of the Source 2 outputs on the 2-port 2-source PNA-X model such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOUR:POW1:PORT:STOP -15
source2:power:port:stop 5, "bal port 1"

Query Syntax

SOURce<cnum>:POWer<port>:PORT:STOP? [src]

Return Type

Numeric

Default

0 dBm


SOURce<cnum>:POWer<port>:SPAN <num>

(Read-Write) Sets the power sweep span power. Must also set:

SENS:SWE:TYPE POWer and SOURce:POWer:CENTer <num>.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1.

<num>

Span power. Actual achievable leveled power depends on frequency.

<port>

If provided, this argument is ignored by the PNA.

Examples

SOUR:POW:SPAN -15
source2:power:span -7

Query Syntax

SOURce<cnum>:POWer:SPAN?

Return Type

Numeric

Default

0 dBm


SOURce<cnum>:POWer<port>:STARt <num>

(Read-Write) Sets the power sweep start power for ALL ports being used by the specified channel. Must also set:

SENS:SWE:TYPE POWer and SOURce:POWer:STOP <num>.

To set start power for a specific port, use SOUR:POW:PORT:STARt.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<num>

Start power.

Note: The range of settable power values depends on the PNA model and if source attenuators are installed. To determine the range of values, perform a query using MAX, then MIN, as an argument. (SOUR:POW:ATT:AUTO must be set to ON)  Example: SOURce:POWer:STARt? MIN

Actual achievable leveled power depends on frequency.

<port>

If provided, this argument is ignored by the PNA.

Examples

SOUR:POW:STAR -15
source2:power:start -7

Query Syntax

SOURce<cnum>:POWer:STARt?

Return Type

Numeric

Default

0 dBm


SOURce<cnum>:POWer<port>:STOP <num>

(Read-Write) Sets the power sweep stop power for ALL ports being used by the specified channel.. Must also set: SENS:SWE:TYPE POWer and SOURce:POWer:START <num>.

To set start power for a specific port, use SOUR:POW:PORT:STOP.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1

<num>

Stop power.

Note: The range of settable power values depends on the PNA model and if source attenuators are installed. To determine the range of values, perform a query using MAX, then MIN, as an argument. (SOUR:POW:ATT:AUTO must be set to ON)  Example: SOURce:POWer:STOP? MAX

Actual achievable leveled power depends on frequency.

<port>

If provided, this argument is ignored by the PNA.

Examples

SOUR:POW:STOP -15

source2:power:stop -7

Query Syntax

SOURce<cnum>:POWer:STOP?

Return Type

Numeric

Default

0 dBm