ML2439A USB Power Meter User Guide : SCPI Commands : SENSe Subsystem
 
SENSe Subsystem
The purpose of the SENSe command subsystem is to directly configure device specific settings used to make measurements, generally parameters related to the RF power sensor and signal processing. The SENSe commands are used to configure the power meter for acquiring data. SENSe enables you to change measurement parameters such as filtering or averaging, sensor bandwidth, operating frequency and calfactors, and measurement gain or offset. The numeric suffix of the SENSe program mnemonic in the SENSe commands refers to a hardware measurement “channel” that is SENSe1 and SENSe2 represent the instrument’s SENSOR 1 and SENSOR 2 signal paths, respectively. The SENSe commands generally DO NOT affect the data processing and display portion of the measurement (see the CALCulate subsystem).
SENSe:AVERage
Description:
Set or return the number of traces averaged together to form the measurement result on the selected channel. Averaging can be used to reduce display noise on both the visible trace, and on marker and automatic pulse measurements. Trace averaging is a continuous process in which the measurement points from each sweep are weighted (multiplied) by an appropriate factor, and averaged into the existing trace data points. In this way, the most recent data will always have the greatest effect on the trace shape, and older measurements will be decayed at a rate determined by the averaging setting and trigger rate. Note that for timebase settings of 500 ns/div and faster, the ML2439A acquires samples using a technique called equivalent time or interleaved sampling. In this mode, not every pixel on the trace gets updated on each sweep, and the total number of sweeps needed to satisfy the AVERage setting will be increased by the sample interleave ratio of that particular timebase.
Syntax:
SENSe[1|2|3|4]:AVERage <numeric_value>
Argument:
<numeric_value> = Numeric_value from 1 to 16,384 (1 = no trace averaging)
Valid Modes:
Pulse
 
SENSe:BANDwidth
Description:
Set or return the sensor video bandwidth for the selected sensor or the trigger channel bandwidth if a trigger channel is selected. HIGH is the normal setting for most measurements. The actual bandwidth is determined by the peak sensor model used. Use LOW bandwidth for additional noise reduction when measuring CW or signals with very low modulation bandwidth. If LOW bandwidth is used on signals with fast modulation, measurement errors will result because the sensor cannot track the fast changing envelope of the signal.
Syntax:
SENSe[1|2|3|4]:BANDwidth <character data>
Argument:
<character data> = { LOW, HIGH }
Valid Modes:
All
 
SENSe:CORRection:CALFactor
Description:
Set or return the frequency calfactor currently in use on the selected channel. Note setting a calfactor with this command will override the “automatic” frequency calfactor that was calculated and applied when the operating frequency was set, and setting the operating frequency will override this calfactor setting.
Syntax:
SENSe[1|2|3|4]:CORRection:CALFactor <numeric_value>
Argument:
<numeric_value> = –3.00 to 3.00 dB, units are optional
Valid Modes:
All
 
SENSe:CORRection:DCYCle
Description:
Set or return the duty cycle correction factor in percent currently in use on the selected channel. Syntax: SENSe[1|2|3|4]:CORRection:DCYCle
Argument:
<numeric_value> = 0.01 to 100.00
Valid Modes:
CW Sensor (Modulated Mode)
 
SENSe:CORRection:FREQuency
Description:
Set or return the RF frequency for the current sensor, and apply the appropriate frequency calfactor from the sensor’s EEPROM table. Application of this calfactor cancels out the effect of variations in the flatness of the sensor’s frequency response. If an explicit calfactor has been set, either manually or via the SENSe:CORRection:CALFactor command, entering a new frequency will override this calfactor and use only the “automatic” frequency calfactor.
Syntax:
SENSe[1|2|3|4]:CORRection:FREQuency <numeric_value>
Argument:
<numeric_value> = 1e6 to 110.0e9 Hz (actual sensor may have narrower range; range may depend on channel bandwidth setting)
Valid Modes:
All
 
SENSe:CORRection:OFFSet
Description:
Set or return a measurement offset in dB for the selected sensor. This is used to compensate for external couplers, attenuators or amplifiers in the RF signal path ahead of the power sensor.
Syntax:
SENSe[1|2|3|4]:CORRection:OFFSet <numeric_value>
Argument:
<numeric_value> = –200.000 to 200.000 dB units are optional.
Valid Modes:
Any
 
SENSe:FILTer:STATe
Description:
Set or return the current setting of the integration filter on the selected channel. OFF provides no filtering, and can be used at high signal levels when absolute minimum settling time is required. ON provides a user-specified integration time, from 2 milliseconds to 15 seconds (see SENSe:FILTer:TIMe command). Note that setting the filter time will force the state to ON. AUTO uses a variable amount of filtering, which is set automatically by the power meter based on the current signal level to a value that gives a good compromise between measurement noise and settling time at most levels.
Syntax:
SENSe[1|2|3|4]:FILTer:STATe <character data>
Argument:
<character data> = {OFF, ON, AUTO}
Valid Modes:
Modulated
 
SENSe:FILTer:TIMe
Description:
Set or return the current length of the integration filter on the selected channel. If the filter state is set to AUTO, querying the time will return -0.01, and if set to OFF, a time query will return 0.00. Note that setting the filter time will force the state to ON.
Syntax:
SENSe[1|2|3|4]:FILTer:TIMe <numeric_value>
Argument:
<numeric_value> = 0.002 to 16.000 in 2 millisecond increments
Valid Modes:
Modulated
 
SENSe:MBUF:ACQuire?
Description:
Starts a new measurement buffer acquisition. This command blocks communication until the number of measurements for each enabled channel is equal to count, a time out has occurred, or the buffer is overrun before it could be read into memory.
Syntax:
SENSe:MBUF:ACQuire?
Returns:
Stop Reason numeric code. 1 = Count Reached, 2 = Timed Out, 3 = Buffer Overrun.
Valid Modes:
Pulse
 
SENSe:MBUF:DELay:END
Description:
Set or return the time in seconds added to the detected end of a burst for analysis. Typically a negative value is used to exclude the falling edge of a burst from the measurement..
Syntax:
SENSe:MBUF:DELay:END <numeric value>
Argument:
<numeric value> = -10e-6 to 100e-3
Valid Modes:
Pulse
 
SENSe:MBUF:DELay:STARt
Description:
Set or return the time in seconds added to the detected beginning of a burst for analysis. Typically used to exclude the rising edge of a burst from the measurement.
Syntax:
SENSe:MBUF:DELay:STARt <numeric value>
Argument:
<numeric value> = -10e-6 to 100e-3
Valid Modes:
Pulse
 
SENSe:MBUF:ENABled:FLAG
Description:
Set or return the bit mask value indicating which MBUF arrays will be filled during a SENSe:MBUF:ACQuire? query.
Syntax:
SENSe:MBUF:ENABled <numeric value>
Argument:
<numeric value> = decimal value representing a 6-bit binary value used to enable/disable mask bits
BIT VALUE DEFINITION
5 32 Enable Sequence Capture
4 16 Enable Start Time Capture
3 8 Enable Duration Capture
2 4 Enable Min. Measurements
1 2 Enable Average Measurements
0 1 Enable Max. Measurements
Valid Modes:
5
 
SENSe:MBUF:GATe:MODe
Description:
Set or return the gate mode used to define the start and end of a measurement time interval.
Syntax:
SENSe:MBUF:GATe:MODe <character data>
Argument:
<character data> = {BURst, MARKer, EXTGATE, PERiodic, EXTTRIG}
Valid Modes:
Pulse
 
SENSe#:MBUF:MEASurements:AVAilable?
Description:
Gets the number of measurements available in the power meter’s internal buffer.
Syntax:
SENSe[1|2|3|4]:MBUF:MEASurements:AVailable?
Returns:
<numeric>
Valid Modes:
Pulse
 
SENSe:MBUF:MEASurements:CLEar
Description:
Clears all cached average, min, max, duration, start time, and sequence numbers.
Syntax:
SENSe:MBUF:MEASurements:CLEar
Argument:
None
Valid Modes:
Pulse
 
SENSe:MBUF:PERiod
Description:
Set or return the period in seconds, that each timed mode measurement is started. Refer to the “SENSe:MBUF:PERiod:DURation” command to set the duration of the measurement.
Syntax:
SENSe:MBUF:PERiod <numeric value>
Argument:
<numeric value> = 100e-9 to 10
Valid Modes:
Pulse
 
SENSe:MBUF:PERiod:DURation
Description:
Set or return the time duration in seconds, that samples are captured during each timed mode MBUF acquisiton.
Syntax:
SENSe:MBUF:PERiod:DURation <numeric value>
Argument:
<numeric value> = 0.001 to 1000
Valid Modes:
Pulse
 
SENSe:MBUF:QUALifier:END
Description:
Set or return the minimum amount of time in seconds power remains below the trigger point to be counted as the end of a burst.
Syntax:
SENSe:MBUF:QUALifier:END <numeric value>
Argument:
<numeric value> = 0.0 to 10e-6
Valid Modes:
Pulse
 
SENSe:MBUF:QUALifier:STARt
Description:
Set or return the minimum amount of time in seconds power remains above the trigger point to be counted as the beginning of a burst.
Syntax:
SENSe:MBUF:QUALifier:STARt <numeric value>
Argument:
<numeric value> = 0.0 to 10e-6
Valid Modes:
Pulse
 
SENSe:MBUF:SESsion:COUNt
Description:
Set or return the count of elements for the MBUF arrays during a SENSe:MBUF:ACQuire? query.
Syntax:
SENSe:MBUF:SESsion:COUNt <numeric data>
Argument:
<numeric data> = 1 to 999999
Valid Modes:
Pulse
 
SENSe:MBUF:SESsion:TIMEout
Description:
Set or return the maximum time in seconds for the MBUF session during a SENSe:MBUF:ACQuire? query.
Syntax:
SENSe:MBUF:SESsion:TIMEout <numeric value>
Argument:
<numeric value> = 1e-3 to 1e3
Valid Modes:
Pulse
 
SENSe:MBUF:START:MODe
Description:
Set or return the mode used to start acquiring MBUF entries.
Syntax:
SENSe:MBUF:GATe:MODe <character data>
Argument:
<character data> = {IMMediate, EXTEnable, EXTStart}
Valid Modes:
Pulse
 
SENSe:PULSe:DISTal
Description:
Set or return the pulse amplitude percentage, which is used to define the end of a rising edge or beginning of a falling edge transition. Typically, this is 90% voltage or 81% power relative to the “top level” of the pulse. This setting is used when making automatic pulse risetime and falltime calculations returned by READ:ARRay:AMEASure:POWer.
Syntax:
SENSe[1|2|3|4]:PULSe:DISTal <numeric_value>
Argument:
<numeric_value> = 50.00 to 100.00
Valid Modes:
Pulse Mode only
 
SENSe:PULSe:ENDGT
Description:
Set or return the point on a pulse, which is used to define the end of the pulse’s “active” interval. This point is defined in percent of the total pulse duration, with 0% corresponding to the midpoint of the rising edge, and 100% corresponding to the midpoint of the falling edge, as defined by the mesial setting. For most pulse “on” average power measurements, it is desirable to exclude the rising and falling intervals, and only measure power over the active portion of the pulse. This is often known as time gating, and is used for the automatic pulse measurements returned by READ:ARRay:AMEASure:POWer.
Syntax:
SENSe[1|2|3|4]:PULSe:ENDGT <numeric_value>
Argument:
<numeric_value> = 60.00 to 100.00
Valid Modes:
Pulse Mode only
 
SENSe:PULSe:MESIal
Description:
Set or return the pulse amplitude percentage, which is used to define the midpoint of a rising or falling edge transition. Typically, this is 50% voltage or 25% power relative to the “top level” of the pulse. This setting is used when making automatic pulse width and duty cycle calculations returned by FETCh:ARRay:AMEASure:POWer.
Syntax:
SENSe[1|2|3|4]:PULSe:MESIal <numeric_value>
Argument:
<numeric_value> = 10.00 to 90.00
Valid Modes:
Pulse Mode only
 
SENSe:PULSe:PROXimal
Description:
Set or return the pulse amplitude percentage, which is used to define the beginning of a rising edge or end of a falling edge transition. Typically, this is 10% voltage or 1% power relative to the “top level” of the pulse. This setting is used when making automatic pulse risetime and falltime calculations returned by FETCh:ARRay:AMEASure:POWer.
Syntax:
SENSe[1|2|3|4]:PULSe:PROXimal <numeric_value>
Argument:
<numeric_value> = 0.00 to 50.00
Valid Modes:
Pulse Mode only
 
SENSe:PULSe:STARTGT
Description:
Set or return the point on a pulse, which is used to define the beginning of the pulse’s “active” interval. This point is defined in percent of the total pulse duration, with 0% corresponding to the midpoint of the rising edge, and 100% corresponding to the midpoint of the falling edge, as defined by the mesial setting. For most pulse “on” average power measurements, it is desirable to exclude the rising and falling intervals, and only measure power over the active portion of the pulse. This is often known as time gating, and is used for the automatic pulse measurements returned by FETCh:ARRay:AMEASure:POWer.
Syntax:
SENSe[1|2|3|4]:PULSe:STARTGT <numeric_value>
Argument:
<numeric_value> = 0.00 to 40.00
Valid Modes:
Pulse Mode only
 
SENSe:PULSe:UNIT
Description:
Set or return the units for entering the pulse distal, mesial and proximal levels. If the function is set to VOLTS, the pulse transition levels will be defined as the specified percentage in voltage. If set to WATTS, the levels are defined in percent power. Many pulse measurements call for 10% to 90% voltage (which equates to 1% to 81% power) for risetime and falltime measurements, and measure pulse widths from the half-power (–3dB, 50% power, or 71% voltage) points.
Syntax:
SENSe[1|2|3|4]:PULSe:UNIT <character data>
Argument:
<character data> = {WATTS, VOLTS}
Valid Modes:
Pulse Mode only
 
SENSe:SENSOR:TYPE?
Description:
Returns the sensor type for the selected channel.
Syntax:
SENSe[1|2|3|4]:SENSOR:TYPE?
Returns:
<character data> = { NONE, CW, VOLT, PEAK }
Valid Modes:
All