/// <summary>Configures common settings for the TxP measurement and selects the measurement.</summary>
/// <param name="wlanSignal">Specifies the WLAN signal to configure.</param>
/// <param name="txPConfig">Specifies the TxP settings to apply.</param>
/// <param name="selectorString">Pass an empty string. The signal name that is passed when creating the signal configuration is used.See the RFmx help for more documention of this parameter.</param>
public static void ConfigureTxP(RFmxWlanMX wlanSignal, TxPConfiguration txPConfig, string selectorString = "")
{
wlanSignal.SelectMeasurements(selectorString, RFmxWlanMXMeasurementTypes.Txp, false);
//Disabled because we are triggering by default
wlanSignal.Txp.Configuration.SetBurstDetectionEnabled(selectorString, RFmxWlanMXTxpBurstDetectionEnabled.False);
wlanSignal.Txp.Configuration.ConfigureAveraging(selectorString, txPConfig.AveragingEnabled, txPConfig.AveragingCount);
wlanSignal.Txp.Configuration.ConfigureMaximumMeasurementInterval(selectorString, txPConfig.MaximumMeasurementInterval_s);
}
/// <summary>Configures common settings for the SEM measurement and selects the measurement.</summary>
/// <param name="wlanSignal">Specifies the WLAN signal to configure.</param>
/// <param name="semConfig">Specifies the SEM settings to apply.</param>
/// <param name="selectorString">Pass an empty string. The signal name that is passed when creating the signal configuration is used.See the RFmx help for more documention of this parameter.</param>
public static void ConfigureSEM(RFmxWlanMX wlanSignal, SEMConfiguration semConfig, string selectorString = "")
{
wlanSignal.SelectMeasurements(selectorString, RFmxWlanMXMeasurementTypes.Sem, false);
wlanSignal.Sem.Configuration.ConfigureSweepTime(selectorString, semConfig.SweepTimeAuto, semConfig.SweepTime_s);
wlanSignal.Sem.Configuration.ConfigureAveraging(selectorString, semConfig.AveragingEnabled, semConfig.AveragingCount, semConfig.AveragingType);
wlanSignal.Sem.Configuration.ConfigureSpan(selectorString, semConfig.SpanAuto, semConfig.Span_Hz);
// Support for custom masks has not been implemented in this module
wlanSignal.Sem.Configuration.ConfigureMaskType(selectorString, RFmxWlanMXSemMaskType.Standard);
}
/// <summary>Performs actions to initiate acquisition and measurement.<para></para> Enables the specified measurement(s) before optionally
/// automatically adjusting the reference level before beginning measurements. Finally, initiates the acquisition and measurement(s).</summary>
/// <param name="wlanSignal">Specifies the WLAN signal to configure.</param>
/// <param name="measurements">Specifies one or more previously configured measurements to enable for this acquisition.</param>
/// <param name="autoLevelConfig">Specifies the configuration for the optional AutoLevel process which will automatically set the analyzer's reference level.</param>
/// <param name="enableTraces">(Optional) Specifies whether traces should be enabled for the measurement(s). See the RFmx help for more documention of this parameter.</param>
/// <param name="selectorString">Pass an empty string. The signal name that is passed when creating the signal configuration is used.See the RFmx help for more documention of this parameter.</param>
/// <param name="resultName">(Optional) Specifies the name to be associated with measurement results. Provide a unique name, such as "r1" to enable
/// fetching of multiple measurement results and traces. See the RFmx help for more documentation of this parameter.</param>
public static void SelectAndInitiateMeasurements(RFmxWlanMX wlanSignal, RFmxWlanMXMeasurementTypes[] measurements, AutoLevelConfiguration autoLevelConfig = default,
bool enableTraces = false, string selectorString = "", string resultName = "")
{
// Aggregate the selected measurements into a single value
// OR of 0 and x equals x
RFmxWlanMXMeasurementTypes selectedMeasurements = 0;
foreach (RFmxWlanMXMeasurementTypes measurement in measurements)
{
selectedMeasurements |= measurement;
}
wlanSignal.SelectMeasurements(selectorString, selectedMeasurements, enableTraces);
if (autoLevelConfig.Enabled)
{
wlanSignal.AutoLevel(selectorString, autoLevelConfig.MeasurementInterval_s);
}
// Initiate acquisition and measurement for the selected measurements
wlanSignal.Initiate(selectorString, resultName);
}
/// <summary>Configures common settings for the OFDM ModAcc measurement and selects the measurement.</summary>
/// <param name="wlanSignal">Specifies the WLAN signal to configure.</param>
/// <param name="modAccConfig">Specifies the OFDM ModAcc settings to apply.</param>
/// <param name="selectorString">Pass an empty string. The signal name that is passed when creating the signal configuration is used.See the RFmx help for more documention of this parameter.</param>
public static void ConfigureOFDMModAcc(RFmxWlanMX wlanSignal, OFDMModAccConfiguration modAccConfig, string selectorString = "")
{
wlanSignal.SelectMeasurements(selectorString, RFmxWlanMXMeasurementTypes.OfdmModAcc, false);
RFmxWlanMXOfdmModAccAcquisitionLengthMode acMode;
if (modAccConfig.AcquisitionLength_s == 0)
{
acMode = RFmxWlanMXOfdmModAccAcquisitionLengthMode.Auto;
}
else
{
acMode = RFmxWlanMXOfdmModAccAcquisitionLengthMode.Manual;
}
wlanSignal.OfdmModAcc.Configuration.ConfigureAcquisitionLength(selectorString, acMode, modAccConfig.AcquisitionLength_s);
wlanSignal.OfdmModAcc.Configuration.ConfigureMeasurementLength(selectorString,
modAccConfig.MeasurementOffset_sym, modAccConfig.MaximumMeasurementLength_sym);
wlanSignal.OfdmModAcc.Configuration.ConfigureOptimizeDynamicRangeForEvm(selectorString, modAccConfig.OptimizeDynamicRangeForEvmEnabled,
modAccConfig.OptimizeDynamicRangeForEVMMargin_dB);
wlanSignal.OfdmModAcc.Configuration.ConfigureAveraging(selectorString, modAccConfig.AveragingEnabled, modAccConfig.AveragingCount);
//Disable the following measurements because SG clocks and LOs are being shared; hence, any measured error would be invalid
wlanSignal.OfdmModAcc.Configuration.SetFrequencyErrorEstimationMethod(selectorString, RFmxWlanMXOfdmModAccFrequencyErrorEstimationMethod.Disabled);
wlanSignal.OfdmModAcc.Configuration.SetIQGainImbalanceCorrectionEnabled(selectorString, RFmxWlanMXOfdmModAccIQGainImbalanceCorrectionEnabled.False);
wlanSignal.OfdmModAcc.Configuration.SetIQQuadratureErrorCorrectionEnabled(selectorString, RFmxWlanMXOfdmModAccIQQuadratureErrorCorrectionEnabled.False);
wlanSignal.OfdmModAcc.Configuration.SetIQTimingSkewCorrectionEnabled(selectorString, RFmxWlanMXOfdmModAccIQTimingSkewCorrectionEnabled.False);
//The following values are defaults, but called out explicitly for clarity
wlanSignal.OfdmModAcc.Configuration.SetEvmUnit(selectorString, RFmxWlanMXOfdmModAccEvmUnit.dB);
wlanSignal.OfdmModAcc.Configuration.ConfigureChannelEstimationType(selectorString, RFmxWlanMXOfdmModAccChannelEstimationType.Reference);
wlanSignal.OfdmModAcc.Configuration.SetBurstStartDetectionEnabled(selectorString, RFmxWlanMXOfdmModAccBurstStartDetectionEnabled.False); //Triggering, so no burst detection
wlanSignal.OfdmModAcc.Configuration.SetAmplitudeTrackingEnabled(selectorString, RFmxWlanMXOfdmModAccAmplitudeTrackingEnabled.False);
wlanSignal.OfdmModAcc.Configuration.SetPhaseTrackingEnabled(selectorString, RFmxWlanMXOfdmModAccPhaseTrackingEnabled.False);
wlanSignal.OfdmModAcc.Configuration.SetChannelEstimationSmoothingEnabled(selectorString, RFmxWlanMXOfdmModAccChannelEstimationSmoothingEnabled.False);
wlanSignal.OfdmModAcc.Configuration.SetCommonClockSourceEnabled(selectorString, RFmxWlanMXOfdmModAccCommonClockSourceEnabled.True);
}