SYST:CONF:EDEVice:PMAR Commands

SYSTem:CONFigure:EDEVice:PMAR

| CALibrate

| FLIMit

| FMAXimum

| FMINimum

| CFACtors

     | STATe

| READing:

     | COUNt

     | NTOLerance

| SENSor

| TABLe:

     | CFAC:

          | DATA

          | FREQuency

     | LOSS:

          | DATA

          | FREQuency

          | STATe

     | RFACtor

| ZERO

(Write-only)  Performs a calibration of the power sensor. Calibration usually involves connecting the power sensor to the meter's 1 mW reference.

• Keysight P-Series sensors have an internal reference so you can calibrate them using this command without connecting to the meters reference port.

• Keysight USB power sensors do not require calibrating.

• For other sensors, refer to the documentation to determine if it has calibration capability.

This command is always synchronous, so *OPC? is the only way to determine that the operation is complete. Set an I/O timeout of at least 20 seconds.

Parameters

<name>

String - Name of the power meter.

Examples

SYST:CONF:EDEV:PMAR:CAL "myDevice"

system:configure:edevice:pmar:calibrate "myDevice"

Query Syntax

Not Applicable

Default

Not Applicable

(Read-Write) Enable or disable the power meter min and max frequencies.

Parameters

<name>

String - Name of the power meter.

<value>

Boolean. State of min and max frequency. Choose from:

OFF or 0 - Min and max frequencies disabled.

ON or 1 - Min and max frequencies enabled.

Examples

SYST:CONF:EDEV:PMAR:FLIM "myDevice", 0

system:configure:edevice:pmar:flimit "myDevice", ON

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:FLIMit? <name>

Return Type

Boolean

Default

OFF

(Read-Write) Set and return the maximum frequency of the power meter.

Parameters

<name>

String - Name of the power meter.

<value>

Numeric - Max frequency in Hz.

Examples

SYST:CONF:EDEV:PMAR:FMAX "myDevice", 1e10

system:configure:edevice:pmar:fmaximum "myDevice", 3e9

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:FMAXimum?  <name>

Return Type

Numeric

Default

Not Applicable

(Read-Write) Set and return the minimum frequency of the power meter.

Parameters

<name>

String - Name of the power meter.

<value>

Numeric - Min frequency in Hz.

Examples

SYST:CONF:EDEV:PMAR:FMIN "myDevice", 1e10

system:configure:edevice:pmar:fminumum "myDevice", 3e9

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:FMAXimum? <name>

Return Type

Numeric

Default

Not Applicable

(Read-Write) Enables/disables use of internal calibration factors for power sensors with built-in calibration factors and reads the current state.

Parameters

<name>

String - Name of the power meter.

<bool>

Choose from:

0 - OFF - Disables the use of internal calibration factors.

1 - ON - Enables the use of internal calibration factors.

Learn about these settings.

Examples

' This example script demonstrates the SCPI set/get of the "Use Internal Cal Factors" property

' for an existing PMAR named 'MyPMAR'.

Option Explicit

dim app

Set app = CreateObject("AgilentPNA835x.Application")

dim scpi

Set scpi = app.ScpiStringParser

Dim opcReply

opcReply = scpi.Parse("SYST:PRES;*OPC?")

opcReply = scpi.Parse("SENS1:SWE:MODE HOLD;*OPC?")

scpi.Parse "SENS1:FREQ:CW 1E9"

scpi.Parse "SENS1:SWE:TYPE CW"

scpi.Parse "SENS1:SWE:POIN 3"

' Activate the PMAR and change the default trace to measure that PMAR connected to port 3

scpi.Parse "SYST:CONF:EDEV:STAT 'MyPMAR', ON"

scpi.Parse "CALC1:PAR:SEL 'CH1_S11_1'"

scpi.Parse "CALC1:PAR:MOD:EXT 'MyPMAR,3'"

scpi.Parse "CALC1:FUNC:TYPE MEAN"

' Disable use of the sensor's internal cal factors, take a sweep and report the Mean

scpi.Parse "SYST:CONF:EDEV:PMAR:CFAC:STAT 'MyPMAR', OFF"

scpi.Parse "SYST:CONF:EDEV:IOENable 'MyPMAR', ON"

opcReply = scpi.Parse("SENS1:SWE:MODE SING;*OPC?")

MsgBox "Use Internal Cal Factors = " & scpi.Parse("SYST:CONF:EDEV:PMAR:CFAC:STAT? 'MyPMAR'") & ", Mean measured val = " & scpi.Parse("CALC1:FUNC:EXEC;DATA?")

' Enable use of the sensor's internal cal factors, take another sweep and report the Mean again

scpi.Parse "SYST:CONF:EDEV:IOENable 'MyPMAR', OFF"

scpi.Parse "SYST:CONF:EDEV:PMAR:CFAC:STAT 'MyPMAR', ON"

scpi.Parse "SYST:CONF:EDEV:IOENable 'MyPMAR', ON"

opcReply = scpi.Parse("SENS1:SWE:MODE SING;*OPC?")

MsgBox "Use Internal Cal Factors = " & scpi.Parse("SYST:CONF:EDEV:PMAR:CFAC:STAT? 'MyPMAR'") & ", Mean measured val = " & scpi.Parse("CALC1:FUNC:EXEC;DATA?")

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:CFACtors:STATe?

Return Type

Boolean

Default

1

(Read-Write) This command, along with SYST:CONF:EDEV:PMAR:READ:NTOL, allows for settling of the power sensor READINGS.

Set and return the maximum number of power readings that are taken at each stimulus point to allow for measurement settling. Each reading is averaged with the previous readings at that stimulus point.

When this average meets the Average:NTOLerance value or this number of readings has been made, the average is returned as the valid reading.

Parameters

<name>

String - Name of the power meter.

<value>

Number of readings. Choose a value between 1 and 25

Examples

SYST:CONF:EDEV:PMAR:READ:COUN "myDevice", 20

system:configure:edevice:pmar:reading:count "myDevice", 10

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:READing:COUNt? <name>

Return Type

Numeric

Default

3

(Read-Write) This command, along with SYST:CONF:EDEV:PMAR:READ:COUN, allows for settling of the power sensor READINGS.

Each power reading is averaged with the previous readings at each stimulus point. When the average meets this nominal tolerance value, or the max number of readings has been made, the average is returned as the valid reading.

Parameters

<name>

String - Name of the power meter.

<value>

Power measurement settling tolerance value in dB. Choose any number between 0 and 5.

Examples

SYST:CONF:EDEV:PMAR:READ:NTOL "myDevice", .5

system:configure:edevice:pmar:reading:ntolerance "myDevice",.01

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:READing:NTOLerance? <name>

Return Type

Numeric

Default

.05

(Read-Write) Sets and returns the power sensor channel (1 or 2) to be used.  This performs the same function as the Use this sensor only checkbox.

Parameters

<name>

String - Name of the power meter.

<value>

Power Meter channel.

1 - Channel A

2 - Channel B

Examples

SYST:CONF:EDEV:PMAR:SENS "myDevice",2

system:configure:edevice:pmar:sensor "myDevice",1

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:SENSor? <name>

Return Type

Numeric

Default

1

(Read-Write) Sets and returns the cal factor data for the power sensor.

Parameters

<name>

String - Name of the power meter.

<value>[,value]

Cal factor data in percent. For each frequency used with SYST:CONF:EDEV:PMAR:TABL:CFAC:FREQ, enter a cal factor number between 1 and 100.

Examples

SYST:CONF:EDEV:PMAR:TABL:CFAC:DATA "myDevice", 98,99,99

system:configure:edevice:pmar:table:cfac:data "myDevice", 97,97,97

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:TABLe:CFAC:DATA? <name>

Return Type

Numeric - one number per table segment.

Default

Not Applicable

(Read-Write) Sets and returns the cal factor frequencies for the power sensor.

Parameters

<name>

String - Name of the power meter.

<value>[,value]

Cal factor frequencies in Hz.

Examples

SYST:CONF:EDEV:PMAR:TABL:CFAC:FREQ "myDevice", 1e7,1e8,1e9

system:configure:edevice:pmar:table:cfac:frequency "myDevice", 5e7,5e8,5e9

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:TABLe:CFAC:FREQuency?<name>

Return Type

Numeric - one number per table segment.

Default

Not Applicable

(Read-Write) Sets and returns the power loss data for the power sensor.

Each table can contain up to 9999 segments. Values can also be loaded using the Characterize Adapter macro.

Parameters

<name>

String - Name of the power meter.

<value>[,value]

Loss data in dB. POSITIVE values in dB are interpreted as LOSS.  To compensate for gain, use negative values.

For each frequency used with SYST:CONF:EDEV:PMAR:TABL:LOSS:FREQ, enter a cal factor number between 1 and 100.

Examples

SYST:CONF:EDEV:PMAR:TABL:LOSS:DATA "myDevice",.01,.02,.03

system:configure:edevice:pmar:table:loss:data "myDevice", .04,.05,.06

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:TABLe:CFAC:DATA? <name>

Return Type

Numeric - one number per table segment.

Default

Not Applicable

(Read-Write) Sets and returns frequencies for the power loss data.

Parameters

<name>

String - Name of the power meter.

<value>[,value]

Power Loss frequencies in Hz.

Examples

SYST:CONF:EDEV:PMAR:TABL:LOSS:FREQ "myDevice",1e7,1e8,1e9

system:configure:edevice:pmar:table:loss:frequency "myDevice",5e7,5e8,5e9

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:TABLe:LOSS:FREQuency? <name>

Return Type

Numeric - one number per table segment.

Default

Not Applicable

(Read-Write) Sets and returns whether to use the power loss table.

Parameters

<name>

String - Name of the power meter.

<value>

Boolean. State of the power loss table. Choose from:

OFF or 0 - Power loss table not used.

ON or 1 - Power loss table used.

Examples

SYST:CONF:EDEV:PMAR:TABL:LOSS:STAT "myDevice",1

system:configure:edevice:pmar:table:loss:state "myDevice",1

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:TABLe:LOSS:STATe? <name>

Return Type

Boolean

Default

OFF

(Read-Write) Sets and returns the reference cal factor for the power sensor.

Note: If the sensor connected to the power meter contains cal factors in EPROM (such as the Keysight E-series power sensors), those will be the cal factors used. The reference cal factor value associated with this command, and any cal factors entered into the PNA for that sensor channel, will not be used.

Parameters

<name>

String - Name of the power meter.

<value>

Reference cal factor in percent.  Choose any number between 1 and 150.

Examples

SYST:CONF:EDEV:PMAR:TABL:RFAC "myDevice", 1

system:configure:edevice:pmar:table:rfactor "myDevice", 1

See example program

Query Syntax

SYSTem:CONFigure:EDEVice:PMAR:TABLe:RFACtor? <name>

Return Type

Numeric

Default

100

(Write-only) Performs a zeroing of the PMAR device.

This command is always synchronous, so *OPC? is the only way to determine that the operation is complete. Set an I/O timeout of at least 20 seconds.

Keysight P-Series sensors do ONLY Internal zeroing. These, and Keysight USB power sensors when Internal is selected, do NOT require disconnecting from the measurement path before zeroing.

All other Keysight sensors do ONLY External zeroing.

Parameters

<name>

String - Name of the power meter.

[,SYNC,<value>]

Optional argument for use with power sensors that support both internal and external types of zeroing such as Keysight USB power sensors.

Choose from:

SYNC,INTernal - Internal zeroing. Power is automatically removed from the sensor input before zeroing occurs (Default setting).

SYNC,EXTernal - External zeroing. First remove the sensor input, then send this command. External zeroing is recommended for powers below -30 dBm with the U2000-Series sensors (-20 dBm for the H models).

Examples

SYST:CONF:EDEV:PMAR:ZERO "myDevice"

system:configure:edevice:pmar:zero "myDevice",sync,internal

Query Syntax

Not Applicable

Default

Not Applicable

17-Aug-2012

Added Cal and Zero (9.80)

14-May-2012

Increased limit of loss table