Site Master MS2085A/MS2089A Programming Manual : MS208xA Commands : High Accuracy Power Meter Commands
 
High Accuracy Power Meter Commands
: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.
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.
:DISPlay:WINDow[:SCALe]:MAXimum <numeric_value> {DBM}
:DISPlay:WINDow[:SCALe]:MAXimum?
Title:
Display Max
Description:
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.
 
Parameter(s):
<numeric_value> {DBM}
Query Return:
Numeric (DBM)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-100 dBm to 20 dBm
:DISPlay:WINDow[:SCALe]:MAXimum:PERCent <percent_value>
:DISPlay:WINDow[:SCALe]:MAXimum:PERCent?
Title:
Display Max In Percent
Description:
This command sets or queries the maximum 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:
100
Range:
1% to 100000%
:DISPlay:WINDow[:SCALe]:MINimum <numeric_value> {DBM}
:DISPlay:WINDow[:SCALe]:MINimum?
Title:
Display Min
Description:
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.
 
Parameter(s):
<numeric_value> {DBM}
Query Return:
Numeric (DBM)
Default Value:
-70 dBm
Default Unit:
dBm
Range:
-100 dBm to 20 dBm
:DISPlay:WINDow[:SCALe]:MINimum:PERCent <percent_value>
:DISPlay:WINDow[:SCALe]:MINimum:PERCent?
Title:
Display Min In Percent
Description:
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. MS24106A 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:CORRection:EXTernal:GAIN <numeric_value> {DB}
:SENSe:CORRection:EXTernal:GAIN?
Title:
External Gain
Description:
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.
 
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
0 dB
Default Unit:
dB
Range:
0 dB to 100 dB
:SENSe:CORRection:EXTernal:LOSS <numeric_value> {DB}
:SENSe:CORRection:EXTernal:LOSS?
Title:
External Loss
Description:
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:FREQuency <numeric_value> {HZ | KHZ | MHZ | GHZ}
:SENSe:FREQuency?
Title:
Frequency
Description:
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: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.
: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.
: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.
Parameter(s):
<DBM|WATTs>
Query Return:
DBM|WATT
Default Value:
DBM