RFmxDemodMX.AutoLevel Method

public int AutoLevel(
	string selectorString,
	double bandwidth,
	double measurementInterval,
	out double referenceLevel
)

Public Function AutoLevel ( 
	selectorString As String,
	bandwidth As Double,
	measurementInterval As Double,
	<OutAttribute> ByRef referenceLevel As Double
) As Integer

Parameters

selectorString  String

Pass an empty string. The signal name passed when creating the signal configuration is used.

bandwidth  Double

Specifies the bandwidth, in hertz (Hz), of the signal to be analyzed.

measurementInterval  Double

Specifies the acquisition length. This value is used to compute the number of samples to acquire from the signal analyzer. This value is expressed in seconds.

Auto Level VI does not use any trigger for acquisition. It ignores the user-configured trigger properties. NI recommends that you set a sufficiently high measurement interval to ensure that the acquired waveform is at least as long as one period of the signal.

referenceLevel  Double

Upon return, contains the estimated peak power level of the input signal. This value is expressed in dBm for RF devices and V_pk-pk for baseband devices.

Return Value

1. Resets the mixer level, mixer level offset and IF output power level offset.
2. Sets the starting reference level to the maximum reference level supported by the device based on the current RF attenuation, mechanical attenuation and preamp enabled settings.
3. Iterates to adjust the reference level based on the input signal peak power.

When using NI 5663, 5665, or 5668R devices, NI recommends that you set an appropriate value for mechanical attenuation before calling the AutoLevel(String, Double, Double, Double) method. Setting an appropriate value for mechanical attenuation reduces the number of times the attenuator settings are changed by this method; thus reducing wear and tear, and maximizing the life time of the attenuator.

Reference