RFmx TDSCDMA DotNET

RFmxTdscdmaMX.AutoLevel Method

Download PDF

Updated2024-07-17
2 minute(s) read

RFmxTdscdmaMXAutoLevel Method

Examines the input signal to calculate the peak power level and sets it as the value of the Reference Level method. Use this method to calculate an approximate setting for the reference level.
The RFmxTDSCDMA Auto Level method completes the following tasks:

Resets the mixer level, mixer level offset, and IF output power offset.
Sets the starting reference level to the maximum reference level supported by the device based on the current RF attenuation, mechanical attenuation, and preamplifier enabled settings.
Iterates to adjust the reference level based on the input signal peak power.
Uses immediate triggering and restores the trigger settings back to user setting after the execution.

You can also specify the starting reference level using the SetAutoLevelInitialReferenceLevel(String, Double) method.
When using PXIe-5663/5665/5668R devices, NI recommends that you set an appropriate value for mechanical attenuation before calling the RFmxTDSCDMA Auto Level 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.

Namespace: NationalInstruments.RFmx.TdscdmaMX
Assembly: NationalInstruments.RFmx.TdscdmaMX.Fx40 (in NationalInstruments.RFmx.TdscdmaMX.Fx40.dll) Version: 24.5.0.49284 (24.5.0.49284)

Syntax

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

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

Parameters

selectorString: Type: SystemString
Pass an empty string. The signal name that is passed when creating the signal configuration is used.
measurementInterval: Type: SystemDouble
Specifies the acquisition length. This value is expressed in seconds. Use this value to calculate the number of samples to acquire from the signal analyzer.
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: Type: SystemDouble
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

Type: Int32
Returns the status code of this method. The status code either indicates success or describes a warning condition.

RFmx TDSCDMA DotNET

Table of Contents

RFmxTdscdmaMX.AutoLevel Method

Syntax

Parameters

Return Value

See Also

Reference

Log in to get a better experience