This command is for in-line power sensor only. It sets or queries the lower limit value of the current forward measurement (e.g. FAVG). To change the lower limit value for different measurement mode, change the forward measurement mode first. If limit state is on (See command :CALCulate{[1]:LIMit:STATe) when the power reading is greater than the upper limit value, :CALCulate{[1]}:FORWard:LIMit:LOWer:FAIL? will report a failure. Note that this command is not valid when relative is on and measurement unit is set to WATT (use the command :CALCulate{[1]}:FORWard:LIMit:LOWer:PERCent instead).
Parameter(s):
<numeric_value> {DBM}
Query Return:
Numeric (DBM)
Default Value:
-50 dBm
Default Unit:
dBm
Range:
-100 dBm to 65 dBm
:CALCulate:FORWard:LIMit:LOWer:FAIL?
Title:
Forward Measurement Lower Limit Check Fail
Description:
This command is for in-line power sensor only. It queries the pass/fail result of the limit check for the current forward measurement. Returns 1 when lower limit check failed, otherwise return a 0 when lower limit check passed.
This command is for in-line power sensors only. It sets or queries the lower limit in percent of the current forward measurement. If limit state is on (See command :CALCulate{[1]:LIMit:STATe), a failure will be reported when the power reading is smaller than the lower limit value.\ Note that this command is not valid when relative is on and measurement unit is set to WATT (use the command :CALCulate{[1]}:LIMit:UPPer:PERCent instead).
This command is for in-line power sensor only. It sets or queries the upper limit value of the current forward measurement(e.g. FAVG). To change the upper limit value for different measurement mode, change the forward measurement mode first. If limit state is on (See command :CALCulate{[1]:LIMit:STATe) when the power reading is greater than the upper limit value, :CALCulate{[1]}:FORWard:LIMit:UPPer:FAIL? will report a failure. Note that this command is not valid when relative is on and measurement unit is set to WATT (use the command :CALCulate{[1]}:FORWard:LIMit:UPPer:PERCent instead).
Parameter(s):
<numeric_value> {DBM}
Query Return:
Numeric (DBM)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-100 dBm to 65 dBm
:CALCulate:FORWard:LIMit:UPPer:FAIL?
Title:
Forward Measurement Upper Limit Check Fail
Description:
This command is for in-line power sensor only. It queries the pass/fail result of the limit check for the current forward measurement. Returns 1 when upper limit check failed, otherwise return a 0 when upper limit check passed.
This command is for in-line power sensors only. It sets or queries the upper limit in percent of the current forward measurement. If limit state is on (See command :CALCulate{[1]:LIMit:STATe), a failure will be reported when the power reading is greater than the upper limit value. Note that this command is not valid when relative is on and measurement unit is set to WATT (use the command :CALCulate{[1]}:LIMit:UPPer:PERCent instead).
Parameter(s):
<percent_value>
Query Return:
Percent
Default Value:
100
Range:
1% to 100000%
:CALCulate:FORWard:RELative:STATe <0 | 1 | ON | OFF>
:CALCulate:FORWard:RELative:STATe?
Title:
Forward Relative Power State
Description:
This command enables or disables the forward relative power level. When Relative is turned on, power readings are made relative to the power value that was measured at the time Relative is turned on.
The forward relative power state will turn off automatically when forward measurement mode is changed.
When measurement mode is CCDF or CREST, turning on relative is not allowed.
This command can only be used with inline power sensors.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:LIMit:ALARm:STATe <0 | 1 | ON | OFF>
:CALCulate:LIMit:ALARm:STATe?
Title:
Limit Alarm State
Description:
This command sets or queries the limit alarm state to ON or OFF. When limit state is on (See command :CALCulate{[1]}:LIMit:STATe) and limit alarm is on, the instrument beeps on every limit checking failure.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:LIMit:LOWer <numeric_value> {DBM}
:CALCulate:LIMit:LOWer?
Title:
Lower Limit Value
Description:
This command sets or queries the lower limit value of the meter. If limit state is on (See command :CALCulate{[1]}:LIMit:STATe) when the power reading is less than the lower limit value, CALCulate[1]:LIMit:FAIL? will report a failure. Note that this command is not valid when relative is on and measurement unit is set to WATT (use the command :CALCulate{[1]}:LIMit:LOWer:PERCent instead).
Parameter(s):
<numeric_value> {DBM}
Query Return:
Numeric (DBM)
Default Value:
-50 dBm
Default Unit:
dBm
Range:
-100 dBm to 20 dBm
:CALCulate:LIMit:LOWer:FAIL?
Title:
Lower Limit Check Fail
Description:
This command queries if the lower limit checking failed. Returns 1 when lower limit check failed, otherwise return a 0 when lower limit check passed.
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:LIMit:LOWer:PERCent <percent_value>
:CALCulate:LIMit:LOWer:PERCent?
Title:
Lower Limit Value In Percent
Description:
This command sets or queries the lower limit value of the meter in percent. Note that the limit checking will be using the limit value in percent if relative is on and unit is set to Watts.
Parameter(s):
<percent_value>
Query Return:
Percent
Default Value:
0
Range:
0% to 99000%
:CALCulate:LIMit:STATe <0 | 1 | ON | OFF>
:CALCulate:LIMit:STATe?
Title:
Limit State
Description:
This command sets or queries the limit state to ON or OFF. Setting the limit state to ON or 1 turns on limit checking. Setting the limit state to OFF or 0 turns off limit checking.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:LIMit:UPPer <numeric_value> {DBM}
:CALCulate:LIMit:UPPer?
Title:
Upper Limit Value
Description:
This command sets or queries the upper limit value of the meter. If limit state is on (See command :CALCulate{[1]:LIMit:STATe) when the power reading is greater than the upper limit value, CALCulate[1]:LIMit:FAIL? will report a failure. Note that this command is not valid when relative is on and measurement unit is set to WATT (use the command :CALCulate{[1]}:LIMit:UPPer:PERCent instead).
Parameter(s):
<numeric_value> {DBM}
Query Return:
Numeric (DBM)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-100 dBm to 20 dBm
:CALCulate:LIMit:UPPer:FAIL?
Title:
Upper Limit Check Fail
Description:
This command queries if the upper limit checking failed. Returns 1 when upper limit check failed, otherwise return a 0 when upper limit check passed.
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:LIMit:UPPer:PERCent <percent_value>
:CALCulate:LIMit:UPPer:PERCent?
Title:
Upper Limit Value In Percent
Description:
This command sets or queries the upper limit value of the meter in percent. Note that the limit checking will be using the limit value in percent if relative is on and unit is set to Watts.
Parameter(s):
<percent_value>
Query Return:
Percent
Default Value:
100
Range:
1% to 100000%
:CALCulate:MAXHold:STATe <0 | 1 | ON | OFF>
:CALCulate:MAXHold:STATe?
Title:
Max Hold State
Description:
This command turns on or off max hold. When max hold is turned on, the maximum power reading is stored and only updated if a new measurement of higher power is made. If averaging is on, max hold displays the maximum value of the non-averaged data. See command :SENSe{[1]}:MAXHold:DATA? to retrieve the max hold data.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:RELative:STATe <0 | 1 | ON | OFF>
:CALCulate:RELative:STATe?
Title:
Relative Power State
Description:
This command enables or disables the relative power level. When Relative is turned on, power readings are made relative to the power value that was measured at the time Relative is turned on.
This command is for in-line power sensors only. It sets or queries the lower limit of the current reverse measurement(e.g. RAVG). To change the lower limit value for different measurement mode, change the reverse measurement mode first. If limit state is on (See command :CALCulate{[1]:LIMit:STATe) when the power reading is greater than the upper limit value, :CALCulate{[1]}:REVerse:LIMit:LOWer:FAIL? will report a failure. Note that this command is not valid when relative is on and measurement unit is set to WATT (use the command :CALCulate{[1]}:REVerse:LIMit:LOWer:PERCent instead).
Parameter(s):
<numeric_value> {DBM}
Query Return:
Numeric (DBM)
Default Value:
-50 dBm
Default Unit:
dBm
Range:
-100 dBm to 65 dBm
:CALCulate:REVerse:LIMit:LOWer:FAIL?
Title:
Reverse Measurement Lower Limit Check Fail
Description:
This command is for in-line power sensor only. It queries if the lower limit checking of the current reverse measurement failed. Returns 1 when lower limit check failed, otherwise return a 0 when lower limit check passed.
This command is for in-line power sensors only. It sets or queries the lower limit in percent of the current reverse measurement. If limit state is on (See command :CALCulate{[1]:LIMit:STATe) when the power reading is greater than the upper limit value, CALCulate[1]:LIMit:FAIL? will report a failure. Note that this command is not valid when relative is on and measurement unit is set to WATT (use the command :CALCulate{[1]}:LIMit:UPPer:PERCent instead).
This command is for in-line power sensors only. It sets or queries the upper limit of the current reverse measurement (e.g. RAVG). To change the upper limit value for different measurement mode, change the reverse measurement mode first. If limit state is on (See command :CALCulate{[1]:LIMit:STATe) when the power reading is greater than the upper limit value, :CALCulate{[1]}:REVerse:LIMit:UPPer:FAIL? will report a failure. Note that this command is not valid when relative is on and measurement unit is set to WATT (use the command :CALCulate{[1]}:REVerse:LIMit:UPPer:PERCent instead).
Parameter(s):
<numeric_value> {DBM}
Query Return:
Numeric (DBM)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-100 dBm to 65 dBm
:CALCulate:REVerse:LIMit:UPPer:FAIL?
Title:
Reverse Measurement Upper Limit Check Fail
Description:
This command is for in-line power sensor only. It queries if the upper limit checking of the current reverse measurement failed. Returns 1 when upper limit check failed, otherwise return a 0 when upper limit check passed.
This command is for in-line power sensors only. It sets or queries the upper limit in percent of the current reverse measurement. If limit state is on (See command :CALCulate{[1]:LIMit:STATe) when the power reading is greater than the upper limit value, CALCulate[1]:LIMit:FAIL? will report a failure. Note that this command is not valid when relative is on and measurement unit is set to WATT (use the command :CALCulate{[1]}:LIMit:UPPer:PERCent instead).
Parameter(s):
<percent_value>
Query Return:
Percent
Default Value:
100
Range:
1% to 100000%
:CALCulate:REVerse:RELative:STATe <0 | 1 | ON | OFF>
:CALCulate:REVerse:RELative:STATe?
Title:
Reverse Relative Power State
Description:
This command enables or disables the reverse relative power level. When Relative is turned on, power readings are made relative to the power value that was measured at the time Relative is turned on.
The reverse relative power state will turn off automatically when reverse measurement mode is changed
This command applies only to AVG mode.
This command can only be used with inline power sensors.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALibration:ZERO
Title:
Zeroing Sensor
Description:
This command performs zeroing of the sensor. This improves low level measurement accuracy by removing measured system noise. Remove any RF input signal before zeroing is recommended. Zeroing sensor will reset the max hold.
This command sets or queries the maximum scale value of the meter display. Note that this command is not valid when relative is on and measurement unit is set to WATT.
This command sets or queries the minimum scale value of the meter display. Note that this command is not valid when relative is on and measurement unit is set to WATT.
This command sets or queries the minimum scale value of the meter display in percent when relative is on and unit is set to Watts.
Parameter(s):
<percent_value>
Query Return:
Percent
Default Value:
0
Range:
0% to 99000%
:MMEMory:STORe:FDATa:CSV <string>,<string>
Title:
Save formatted data to csv file
Description:
This command saves the formatted data to csv file in specified file location. The file location is resolved using the MSUS and file path parameters. These parameters are case sensitive.
Parameters:
1. File path: The file path (including file name) relative to the MSUS root directory. File extension should not be specified.
2. MSUS: Device to save the file on. See MMEMory:CATalog:MSUSs? for information on obtaining the list of available devices.
Parameter(s):
<string>,<string>
:SENSe:APERture <numeric_value>
:SENSe:APERture?
Title:
Power Aperture Value
Description:
This command sets or queries the power sensor aperture value. The aperture min/max values will vary depending on the sensor model. Note: This command is not available for the MA24106A sensor. Use the aperture mode command instead.
MA241xxA series: 0.01ms to 300ms
MA242x8A series: 0.01ms to 1000ms
MA243x0A series: 0.01ms to 1000ms
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
1
Range:
0.01 to 1000
:SENSe:APERture:MODE <HAT|LAT>
:SENSe:APERture:MODE?
Title:
Aperture Mode
Description:
This command sets or queries the aperture mode for MA24106A. MA24106A has Low Aperture Time(LAT) for fast reading or High Aperture Time (HAT) for more accurate readings.
Parameter(s):
<HAT|LAT>
Query Return:
HAT|LAT
Default Value:
LAT
:SENSe:AVERage:COUNt <numeric_value>
:SENSe:AVERage:COUNt?
Title:
Averaging Count
Description:
This command sets or queries the number of measurements to be averaged in a rolling average.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
1
Range:
1 to 100
:SENSe:AVERage:SWEep?
Title:
Averaging Sweep Count
Description:
This command queries the number of sweep averages that have taken place.
Query Return:
Numeric
Default Value:
1
Range:
1 to 100
:SENSe:CCDFthreshold <numeric_value>
:SENSe:CCDFthreshold?
Title:
CCDF Threshold
Description:
This command sets or queries the CCDF Threshold from a minimum of 3.0 DBM to 54.77 DBM.
This command can only be used with inline power sensors.
This command sets or queries for the external gain. Changes to the external gain will update the display min and max values and limit upper and lower values.
This command sets or queries for the external loss. Changes to the external loss will update the display min and max values and limit upper and lower values.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
0 dB
Default Unit:
dB
Range:
0 dB to 100 dB
:SENSe:DUTYcycle <percent_value>
:SENSe:DUTYcycle?
Title:
Duty Cycle
Description:
This command sets or queries the duty cycle from 0.1% up to 100%.
This command can only be used with inline power sensors and when forward measurement mode is set to Burst Average Manual.
This command sets or queries the frequency. Note that the frequency range are sensor dependent.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
1000000000 Hz
Default Unit:
Hz
Range:
10000 Hz to 40000000000 Hz
:SENSe:FREQuency:SSTandard:CATalog?
Title:
Frequency Signal Standard Catalog Query
Description:
This command returns a list of available signal standards separated by commas. Example of the return is None, P-GSM 900 - Uplink,P-GSM 900 - Downlink,DCS 1800 - Uplink,DCS 1800 - Downlink\
:SENSe:FREQuency:SSTandard:NAME <string>
:SENSe:FREQuency:SSTandard:NAME?
Title:
Frequency Signal Standard
Description:
This command sets or queries the frequency signal standard. The <string> argument is the name of the desired signal standard. For example, if the desired Signal Standard is P-GSM 900 - Uplink then the value of the <string> argument would be "P-GSM 900 - Uplink"
Parameter(s):
<string>
Default Value:
None
:SENSe:MAXHold:DATA?
Title:
Max Hold Power Reading
Description:
This command returns the max power level readings when max hold is set to on. The query response is a JSON (http://json.org/) string of property object : {key : value} pairs. On error, the response is an empty JSON object {}. The data will return in the following format:
{ "powerInLog": {"units" : string, "value" : number}, "powerInLin": {"units" : string, "value" : number}, } When relative is turned on, data are returned in unit of dB and percent. When relative is turned off data are returned in unit of dBm and milliwatts. Note that changing any setting resets the max hold.
Default Value:
{}
:SENSe:MODType <NONE|GSM|SINGle|MULT|ISDB|CDMA>
:SENSe:MODType?
Title:
Modulation Type
Description:
This command sets or queries the modulation type.
Set the available modulation types with the enums on the left hand side:
{ NONE - None,
GSM - GSM GPRS EDGE,
SINGle - WCDMA HSPA single carrier,
MULT - WCDMA HSPA multi carrier,
ISDB - ISDB T,
CDMA - CDMA IS95 2000 EVDO
}
This command can only be used with inline power sensors.
Parameter(s):
<NONE|GSM|SINGle|MULT|ISDB|CDMA>
Query Return:
NONE|GSM|SING|MULT|ISDB|CDMA
Default Value:
NONE
:SENSe:POWer:DATA?
Title:
Power Reading
Description:
This command returns the power level readings. The query response is a JSON (http://json.org/) string of property object : {key : value} pairs. On error, the response is an empty JSON object {}. The data will return in the following format:
{ "powerInLog": {"units" : string, "value" : number}, "powerInLin": {"units" : string, "value" : number}, } When relative is turned on, data are returned in unit of dB and percent. When relative is turned off data are returned in unit of dBm and milliwatts.
This command sets or queries the forward measurement mode for inline power sensors (MA24103A, MA24105A).
Available forward modes are::
{ FAVG - Forward Average Power,
CRES - Crest Average Power,
BAM - Burst Average Manual,
PEAK - Peak Envelope Power,
BAA - Burst Average Auto,
CCDF - Complementary Cumulative Distribution Function
}
This command can only be used with inline power sensors.
Parameter(s):
<FAVG|CRESt|BAM|PEAK|BAA|CCDF>
Query Return:
FAVG|CRES|BAM|PEAK|BAA|CCDF
Default Value:
FAVG
:SENSe:POWer:INLine:DATA?
Title:
Inline Power Reading
Description:
This command returns the inline power level readings or other values specified by the forward and reverse measurement modes and the summary state. The query response is a JSON (http://json.org/) string of property object : {key : value} pairs. On error, the response is an empty JSON object {}. The data will return in the following format:
{ "forward": {
"ForwardPowerInLin": {
"units": "mW",
"value": "1067.09"
},
"ForwardPowerInLog": {
"units": "dBm",
"value": "10.28"
},
"mode": "FAVG"
},
"reverse": {
"ReversePowerInLin": {
"units": "mW",
"value": "137.03"
},
"ReversePowerInLog": {
"units": "dBm",
"value": "1.37"
},
"mode": "RAVG"
}
} When relative is turned on, data are returned in unit of dB and percent. When relative is turned off data are returned in unit of dBm and milliwatts.
This command can only be used with inline power sensors.
When summary state is on data will return in the following format. It overrides the selections of the forward and reverse measurement modes:
{ "Summary": {
"BAA": {
"units": "mW",
"value": "0.00"
},
"BAM": {
"units": "mW",
"value": "3.15"
},
"CCDF": {
"units": "%",
"value": "0.00"
},
"CRES": {
"units": "dB",
"value": "15.79"
},
"FAVG": {
"units": "dBm",
"value": "3.15"
},
"PEAK": {
"units": "dBm",
"value": "18.93"
},
"RAVG": {
"units": "dBm",
"value": "0.90"
},
"REFL": {
"units": "",
"value": "0.77"
},
"RLOS": {
"units": "dB",
"value": "2.25"
},
"VSWR": {
"units": "",
"value": "7.78"
}
}
} More example output: When forward mode set to FWD and reverse mode set to VSWR, the data will return in the following format: { "forward": {
"ForwardPowerInLin": {
"units": "mW",
"value": "2786.12"
},
"ForwardPowerInLog": {
"units": "dBm",
"value": "14.45"
},
"mode": "AVG"
},
"reverse": {
"mode": "VSWR",
"unit": "",
"value": "8.32"
}
} When forward mode set to CCDF and reverse mode set to VSWR, the data will return in the following format:
Note: VSWR has no units. CCDF has unit of %. { "forward": {
"mode": "CCDF",
"unit": "%",
"value": "17.26"
},
"reverse": {
"mode": "VSWR",
"unit": "",
"value": "16.76"
}
} Mapping of the measurement mode short to long form is as follows:
+-------+--------------------------------------------------------------+ | Short | Long Form | +-------+--------------------------------------------------------------+ | CRES | Crest Factor | | BAM | Burst Average Manual | | CCDF | CCDF | | PEAK | Peak Envelope Power | | BAA | Burst Average Auto | | REFL | Reflection Coefficient | | RLOS | Return Loss | | VSWR | VSWR | | FAVG | Forward Average Power | | RAVG | Reverse Average Power | +-------+--------------------------------------------------------------+\
:SENSe:POWer:REVerse <RAVG|REFL|RLOSs|VSWR>
:SENSe:POWer:REVerse?
Title:
Reverse Measurement Mode
Description:
This command sets or queries the reverse measurement mode for inline power sensors (MA24103A, MA24105A).
Available reverse modes are:
{ RAVG - Reverse Average Power,
REFL - Reflection Coefficient,
RLOS - Return Loss,
VSWR - Standing Wave Ratio
}
This command can only be used with inline power sensors.
Parameter(s):
<RAVG|REFL|RLOSs|VSWR>
Query Return:
RAVG|REFL|RLOS|VSWR
Default Value:
RAVG
:SENSe:SUMMary <0 | 1 | ON | OFF>
:SENSe:SUMMary?
Title:
Summary Mode State
Description:
This command sets or queries the summary mode state. When summary mode is ENABLED, the inline power sensor will
return all measurements readings. When summary mode is DISABLED, the inline power sensor will return forward and reverse
readings.
This command can only be used with inline power sensors.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:SENSe:SWEep:MODE <CONTinuous|SINGle>
:SENSe:SWEep:MODE?
Title:
Set Sweep Mode
Description:
This command sets or queries whether the measurement is set for continuous measurement or single measurement. In SINGle mode, each measurement can be activated by :TRIGger[:SEQuence][:REMote]:SINGle. If averaging is turned on, a complete set of measurements is performed based on the averging count.
Parameter(s):
<CONTinuous|SINGle>
Query Return:
CONT|SING
Default Value:
CONTinuous
:SENSe:USBDevice:PSENsor:INFormation?
Title:
Sensor Information Query
Description:
Returns the USB Power Sensor information. The response is formatted as a JSON (http://json.org/) array of name, value pair result objects. Sensor information contains the following:
{ "model": <model>, "frequencyRange": <minimum frequency in Hz, maximum frequency in Hz>, "serialNumber": <serial number>, "firmwareVersion": <version number>, "isConnected": <true|false> } Note that only one power sensor is supported at a time. The command will return the information of the first sensor connected.
:SENSe:VBW <FULL|FOUR|TWO>
:SENSe:VBW?
Title:
Video Bandwidth
Description:
This command sets or queries the video bandwidth quality.
Set the available video bandwidth qualities with the enums on the left hand side:
{ FULL - Full,
TWO - Two Hundred KHz,
FOUR - Four KHz
}
This command can only be used with inline power sensors.
Parameter(s):
<FULL|FOUR|TWO>
Query Return:
FULL|FOUR|TWO
Default Value:
FULL
:TRIGger[:SEQuence][:REMote]:SINGle
Title:
Initiate Single Sweep
Description:
Initiates a sweep/measurement. If :SENSe{[1]}:SWEep:MODE is set to CONTinuous, or if :SENSe{[1]}:SWEep:MODE is set to SINGle but the current sweep has not completed yet, this command is ignored. This command is overlapped. It can be used in combination with *OPC? to synchronize the capture of one complete set of data. When this command is received, the pending operation bit is set. The pending operation will finish once the sweep/measurement is done. Clients can use *OPC? to 'block' until the sweep/measurement is completed.
:UNIT:POWer <DBM|WATTs>
:UNIT:POWer?
Title:
Display Power Unit
Description:
This command sets and queries the display measurement unit.